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PREFACE 


LY28-1200-4 


This publication describes the internal logic and organization 


of the system initialization process. The publication is 
intended for persons who are involved in modifying or debugging 
system initialization programs. For additional internal 


information about the use and operation of the MVS system, refer 


to the publication System Programming Library: Initialization 
and Tuning. 


HOW THIS PUBLICATION IS ORGANIZED 


This publication contains s1x chapters, five appendixes, and an 
1ndex. Following, 1s a synopsis of the information contained in 
each section: 


e Introduction -- a summary of system initialization functions 
and internal characteristics; maps of real and virtual 
storage. 

e Data Areas ~-- descriptions of data areas used during IPL and 


NIP processing; references to microfiche publications. 


@ Diagnostic Aids -- Information that can be used for 
diagnosing problems in system initialization programs. 


@ Program Organization -- a description of module-to-module 
flow during system initialization. 


@ Method of Operation -- a functional approach to system 
initialization using both diagrams and text. 


e Module Descriptions -- an alphameric list of module 
descriptions, including operation, entry, and exit. 


0 Appendix A -- brief descriptions of IPL macro instructions. 
e Appendix B —-- brief descriptions of NIP macro instructions. 
0 Appendix C -- brief descriptions of IPL service routines. 
0 Appendix D -- brief descriptions of NIP service routines. 
0 Appendix E -- a list of the abbreviations and acronyms used 


in this publication, with their meanings. 
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Summary of Amendments 
for LY28-1200-4 
for MVS/System Product Version 2 Release 2.0 


This edition contains changes to support of MVS/System Product 
Version 2 Release 2.0. The following changes include: 


e 3 new IRIMs loaded by IEAIPLOO 
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0 Changed modules 
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Summary of Amendments 
for LY28-1200-3 
for MVS/System Product Version 2 Release 1.7 


This edition contains changes to support of MVS/System Product 
Version 2 Release 1.7. The following changes are included: 


0 NIP Control and Service Routine CIEAVNIPM) 
0 A new module: Reconfiguration Installed Resources RIM - 
entry point IEAVNP27 
0 Changes to support the Vector Facility Enhancement include: 
_ Updates to the NIP Control and Service Routine 
CIEAVNIPM). 
- The addition of prologue format documentation for 
Tey Nr OO, an existing module that changed in this 
release. 


Editorial and maintenance changes include: 


e Reformatting of Figure 1~l System Initialization Summary. 
e Updates to the Master Scheduler Initialization diagram in 
support of TSO/E Release 2. 


Summary of Amendments 
for LY28-1200-2 
for MVS/System Product Version 2 Release 1.3 


This major revision contains editorial and technical changes in 
support of extended storage and service processors. These 
changes include two new modules: 


0 TEAIPL10 
° TEAIPL20 


Module descriptions have been added for: 


IARMFRIM TARMIIPL IARMNRIM, 

ITARMSRIM IARMTRIM IARMURIM. 
The following modules contain technical updates: 

IEAIPLOO IEAIPLO6 IEAIPL99, 

IEAVNIPO IEAVNIPM IEAVNPO2, 

IEAVNPD8 IEAVRTOD IEFJSINT. 
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SECTION 1. INTRODUCTION 


C 


System initialization is the process that prepares the control 
program and its environment to handle work. The process begins 
when the system operator activates the LOAD function for the 
processor and ends when the operating system is ready for work. 


The system initialization process has three phases: 


e initial program loader CIPL) 
° nucleus initialization program CNIP) 
e master scheduler initialization. 


For an overview of the virtual storage areas initialized by the 
LOAD function and the three phases of system initialization, see 
Figure l-l. 
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OGRAM LOADE IPL) 
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The system initialization process consists of three phases. The 
initial program loader CIPL) is the first phase and includes the 
resource initialization modules CIRIMS). 


When the operator activates the LOAD function of the processor, 
the service processor loads the IPL control module, IEAIPLOO, 
into real storage starting at location 0. 


IEAIPLOO clears to zeroes each 4K frame of online real storage 
above the IEAIPLOO program and sets each corresponding storage 
key to zero. IEAIPLOO clears storage up to the storage address 
limit it obtains from the service processor. It then searches 
the system residence volume (SYSRES) for the SYS1.NUCLEUS data 
set, which contains modules needed for system initialization. 
IEAIPLOO passes control to IPL resource initialization modules 
CIRIMs) that initialize the system resources that IPL is 
responsible for. 


IEAIPLOO provides the services required by the IRIMs. It 
services page faults and segment faults by assigning frames of 
real storage to each page of virtual storage that the IRIMs 
request. It also supports services via the supervisor call 
CSVC) instruction. 
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executes a direct access channel program. 


enters a disabled wait state. 


ISVCDAT switches translation mode. 


ISVCEXIT 
ISVCPGFX 
ISVCFIND 


provides an exit from SVCFLIH. 
backs virtual storage with real frames. 


reads the directory entry of a member of 


SYS1.NUCLEUS. 


ISVCLOAD 
ISVCSTOR 


ISVCCNVT 
CTTRD to 


ISVCSSCH 


loads a module into real storage. 
allocates contiguous frames. 


converts a relative SYSIL.NUCLEUS address 
an absolute volume address (CCHHR). 


starts the IPL subchannel and then checks 


its status. 


ISVCSYNC 
ISVCCSEG 


builds and loads a PSN. 


builds segments by building page tables. 
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IPL RESOURCE INITIALIZATION MODULES (IRIMS) 


In addition to IEAIPLO0, IPL is made up of resource 
initialization modules that initialize the various resources 
that IPL is responsible for. The IPL control module, IEAIPLOO, 
controls the loading and deleting of the IRIMs. IEAIPLO1 
determines the order of the loading of the IRIMS. The following 
lists each IRIM in the order of invocation and gives a brief 
description of its function: 


IEAIPL10 


IEAIPL20 


IEAIPL30 


IEAIPL4O 


ITEAIPL41 


TEAIPLOS 
IEAIPLO2 


IEAIPLOG 


IEAIPLO6 


IEAIPLO7 


IEAIPLO3 


IEAIPL99 


Invokes the SCP INFO functions of the service 
processor. CIPL IRIM) 


Validates the system storage and places all valid 
frames on the available frame queue. CIJPL IRIM) 


Initializes the IPL WTO facility service in the IPL 
work space then IPL-WTOs to the system console. CIPL 
IRIM) 


Identifies the device support modules. IEAIPL40 is 
an I/0 supervisor CIOS) IRIM. 


Determines the DAT-on nucleus to be loaded, and 
determines the control section in all the modules 
that are going to be loaded into the nucleus 
CIEANUCOx). CIPL IRIM) 


Builds a nucleus map (CNUCMAP). CIPL IRIM) 


Loads the DAT-off nucleus into real storage, reads 
the control sections of all of the modules being 
loaded into the nucleus region and resolves external 
references between these modules. CIPL IRIM) 


Allocates storage for the page frame table, the 
system queue area (SQA), the extended SQA CESQA), 
and the extended local system queue area CELSQA) for 
the master scheduler address space. IEAIPL0O4 is the 
virtual storage management (VSM) IRIM. 


Initializes the page frame table, the RSM internal 
table (RIT), the RSM address space block CRAB), and 
the RAB extension CRAX) for the master scheduler 
address space. IEAIPLO0O6 is the real storage 
management CRSM) FRIM. 


Resolves the AMODE bits of the nucleus-resident SVC 
and extended SVC router CESR) tables. IEAIPLO7 is 
the supervisor control IRIM. 


Builds the resident ERP table and sets the DDT 
pointer in each UCB. Initializes the unit control 
block CUCB) for the IPL device. IEAIPLO3 is an 1/0 
supervisor (IOS) IRIM. 


Copies the LPA device Support module list (built by 
IEAIPL40) into the extended system queue area 
CESQA), moves the IPL Message Queue into the system 
queue area (SQA), copies IPL information into common 
storage areas, initializes storage that is 
configured offline, initializes any remaining 
storage not as yet initialized as preferred and 
non-preferred storage, builds the available frame 
queues, and establishes addressability for the 
nucleus initialization program (NIP). CIPL IRIM) 
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NUCLEUS INITIALIZATION PROGRAM (NIP) 


The nucleus initialization program (NIP) is the second phase of 
the system initialization process. NIP controls the 
initialization of system resources, but the resource 
initialization modules (RIMs) actually perform the work. NIP 
and the RIMs initialize real and virtual storage, processors, 
and devices, provide access to various system data sets, and 
initialize hardware recovery facilities, the generalized trace 
facility, and the resource managers in the supervisor component. 
In the course of their processing, NIP and the RIMs create the 
master scheduler address space in which they operate. 


The NIP modules are: 


IEAVNIPO Prepares an environment in the master scheduler 
address space for execution of the RIMs. IEAVNIPO 
loads the main NIP control module IEAVNIPM. 


IEAVNIPM Loads, passes control to, and deletes the RIMs. 
Gnce loaded, it remains in storage until the 
completion of the second phase of system 
initialization. IEAVNIPM loads and passes control 
to the last NIP module, IEAVNIPX. 


IEAVNPC1 Selects the NIP console and identifys it to IEAVNIPM 
for initial operator communication. 


IEAVNP76 Initializes SYS1.LOGREC. 


IEAVNPO3 Checks the syntax of the system parameters and 
places them in PARMTAB. It processes the SYSP, LNK, 
APF and LNKAUTH parameters and opens the system data 
set SYS1.PARMLIB and the data sets specified as part 
of the LNKLST concatenation. IEAVNPO3 is a NIP RIM. 


IEAVNPX1 Performs initial NIP cleanup and prepares for the 
creation of additional address spaces. IEAVNPX1 is 
a NIP RIM. 

IEAVNIPX Removes from storage the remaining NIP modules and 


any programs that have been loaded and passes 
control to master scheduler initialization. 


RESOURCE INITIALIZATION MODULES (RIMS) 


1-6 


NIP is made up of NIP modules and resource initialization 
modules (RIMs) that initialize the various system resources that 
NIP is responsible for. NIP's main control routine, IEAVNIPM, 
controls the loading and deleting of the RIMs. 


The following lists each RIM and gives a brief description of 
its function: 


e Service Processor — initializes the control blocks that the 
service processor CALL SVC uses to communicate with the 
service processor. CIEAVNPE6) 

° Recovery termination management (RTM) — initializes RTM 


control blocks. CIEAVNPAG6, IEAVNPD6) 


0 Machine check handler (MCH) — initializes the machine check 
handler control blocks. CIEAVNPO6) 


o Reconfiguration — calls IEAVRTOD to initialize the 
time-of-day (TOD) clock for the IPL processor and IEEVCPR to 
bring online the non-IPL processors. CIEAVNPOO, IEAVNP27) 


0 Input/output supervisor (I0S) — initializes IOS control 
blocks and unit control blocks CUCBs) for I/70 devices in the 
configuration. CIEAVNPA2, IEAVNPB2, IEAVNF2) 
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Nucleus initialization process — opens system data sets, 
merges system parameters, initializes the NIP console, and 
performs clean up processing for the nucleus initialization 
program itself. CIEAVNPC1, IEAVNP03, IEAVNPX1, IEAVNIPX) 


Virtual storage access method (VSAM) — opens the system 
catalog and VSAM data sets for NIP, performs LOCATE 
processing for NIP, closes the system catalog at the end of 
NIP processing. CIEAVNP11, IEAVNP1B) 


Logrec initialization — initializes SYS1.LOGREC. 
CIEAVNP76) 
Real storage management (RSM) — initializes the real 


storage management and extended storage management, and 
processes the REAL, VRREGN, and RSU system parameters. 
CIEAVNPE8, IEAVNPD8) 


Global resource serialization — initializes control blocks 
in SQA and creates a system address space named GRS for 
Global resource serialization. CIEAVNP23/ISGNCBIM, 
IEAVNP33/ISGNTASC) 


Auxiliary storage management (ASM) — opens page and swap 
data sets; initializes ASM control blocks; during quick or 
warm start, recovers the pageable link pack area. 
CIEAVNPOG/ILRASRIM and IEAVMP14/7ILRASRML1) 


Virtual storage management (VSM) — initializes control 
blocks necessary for controlling the system queue area and 
the common service area. CIEAVNPA8, IEAVNPB8) 


Supervisor control —- initializes the address space vector 
table with the maximum number of address spaces permitted in 
the system CIEAVNP09) and may prompt the operator to set the 
TOD clock CIEAVNP20). 


Contents supervision — initializes the pageable link pack 
area CPLPA), and updates the LPA with installation-sSpecified 
modifications. CIEAVNPO5) 


Event notification facility (ENF) — initializes the ENF 
control blocks. CIEAVNP47) 


System resources manager (SRM) — initializes SRM tables; 
initializes the value of the system automatic priority group 
CAPG); builds control blocks for monitoring logical I/0 
channel use and for storing the installation performance 
specification CIPS) and the installation control 
specification; and sets parameters for SRM from the IEAOQPTx~x 
SYS1.PARMLIB member. CIEAVNP10, IEAVNP1F) 


Dumping services — initializes the system address space 
required for dumping volatile data, processes the DUMPDS 
command, processes the post SVC dump exits, and initializes 
the SVC dump data areas, the SYS1.DUMP data sets), and the 
default options for the contents of SYSABEND, SYSMDUMP, and 
SYSUDUMP. CIEAVNP57, IEAVNPD1, and IEAVNPD2) 


Cross memory — builds and initializes the program 
call/authorization (PC/AUTH) tables that are used for cross 
memory operations. CIEAVNPF5) 


System trace —- creates the system trace address space and 
initializes the trace function. CIEAVNP51) 


Communications task for the CON system parameter —— 
initializing the MCS consoles and some Communication Task 
parameters (such as hardcopy log, write-to-operator buffers, 
etc) found in SYS]1.PARMLIB. CIEAVNPAL). 


Data management — builds a table of authorized appendage 
routine names to be used by data management during OPEN 
processing. CIEAVNP16) 
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o Master scheduler initialization interface — sets up an 
interface with master scheduler initialization by passing 
system parameters that will be used later during master 
scheduler initialization. CIJEAVNP13, ITEAVNP18, IEAVNP20) 


© Generalized trace facility (GTF) —- initializes the 
interface between GTF and monitor call (MC) processing. 
CIEAVNP17) 


© Scheduler Interface to the General Parmlib Scan Routines 
—initializes a parameter list (IEEZB819) and invokes the 
parmlib scan routine CIJEEMB888&) to process the SCHEDxx, 
SYS1.PARMLIB member. 


© Mass storage system communicator (MSSC) — initializes the 
software support for the mass storage system (MSS) and 
prepares the MSS hardware for mounting and demounting mass 
storage volumes. (CA mass storage volume consists of the two 
magnetic cartridges that contain the contents of a 3330 DASD 
volume.) (CIEAVNP19) 


O Volume attribute allocation processing — initializes UCBs 
with use and mount status information about volumes. 
CIEAVNPL5/IEAVAPQOO) 


NIP SERVICE ROUTINES 


NIP service routines provide NIP modules and RIMS with functions 
that are frequently required, or they simulate functions that 
are not available in the system during NIP. NIP service 
routines are all contained in the IJEAVNIPM load module. The 
following lists the NIP service routines and the functions each 


performs: 

NIPMOUNT Ensures that required direct access or tape volumes 
are online and available for further NIP processing. 

NIPOPEN Performs the OPEN function of creating and 
initializing a DEB to describe a specified data set 
or concatenation of data sets. 

NIPPRMPT Prompts the operator for required system parameters 
that have not been specified or that have been 
invalidly specified. 

NIPSENSE Interprets sense data after an ]/0 error occurs. 


NIPSWAIT Places the system in a disabled wait state. 


NIPTIME Provides the time of day in decimal for 
time-stamping messages, or provides a fullword 
binary value that reflects the number of hundredths 
of seconds elapsed since JEAVNIPM was first entered. 


NIPUCBFEN Locates a UCB. 
NIPWTO Writes messages to the master operator console. 


NIPWTOR Writes messages to the master operator console and 
reads the reply. 


NIPWTOR2 (1) Waits for the completion of an operator's reply 
associated with an earlier NIPWTOR message, (2) 
frees a SQA reply buffer, or (3) frees the 
master~-console-image buffer. 


1-8 MVS/XA System Init Logic LY28-1200-4 (c) Copyright IBM Corp. 1982, 1987 


J 








C 


"Restricted Materials of IBM" 
Licensed Materials — Property of IBM 


LY28-1200-4 


MASTER SCHEDULER INITIALIZATION 


Master scheduler initialization is the third and final phase of 
the system initialization process. It performs initialization 
functions for the master scheduler's address space. First, it 
loads routines required by the system: system-initiated cancel, 
SWA management, and resource management routines. It builds the 
control blocks that describe each defined subsystem, to the 
subsystem interface and the subsystem allocation sequence table 
CSAST). It performs master trace initialization, if required. 
It performs final initialization for the communications task. 

It attaches the security initialization routine, allows it to 
process, and detaches it when complete. 


Next, master scheduler initialization attaches and initializes 
tasks that remain as permanent system tasks after system 
initialization. These tasks include the missing-interrupt 
handler (MIH), the IPL’outage recorder, and three recovery 
termination tasks (Cthe asynchronous recording task, the address 
space termination task, and the SVC dump task for the master 
scheduler's address space). Master scheduler initialization 
calls I0S to initialize dynamic pathing and establish the I0S 
storage manager as an event notification facility CENF) 
listener. This portion of master scheduler initialization 
processes the automatic commands that NIP has obtained from 
SYS1.PARMLIB, sets up the last phase of ASM initialization, and 
links to the subsystem initialization routines whose names 
appear in SYS1.PARMLIB. 


Finally, master scheduler initialization processes the START 
command for the job entry subsystem (creating a new address 
space), and prepares the system log for recording. The system 
1s now initialized and ready to receive work in the form of 
system commands and user jobs. 


Master scheduler initialization consists of three load modules 
located in SYSL.LINKLIB: IEEVIPL, IEEMB860, and IEEVWAIT. 
IEEVIPL receives control from NIP to begin the initialization of 
master scheduler's address space. IEEVIPL calls routines to 
perform various initialization functions, then passes control 
via the initiator to IEEMB860. The initiator interprets the JCL 
contained in SYS]1.LINKLIB (MSTJCLxx member) in preparation for 
attaching IEEMB&860. Therefore, IEEMB860 and its subroutines 
have access to those system data sets defined by the JCL. 


When IEEVWAIT receives control from IEEMB&860 via XCTL, it 
performs its initialization functions, processes the START 
command for the job entry subsystem, and waits for notification 
to process system commands. IEEVWAIT represents the permanent 
system task known as the master scheduler. 
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SYSTEM COMPONENT ADDRESS SPACE INITIALIZATION 


A system component can execute in the address space of a program 
that requests its services, in its own address space, or 
Partially in both the requesting address space and its own 
address space. By creating its own address space to hold some 
or all of its data and executable code, a system component can 
reduce the amount of storage it requires in the common area. 


If a system component has its own address space, that address 
space must be created and initialized or be capable of handling 
requests before any other address space requests the component's 
services. The services of some components must be available at 
the completion of system initialization (master scheduler 
initialization and JES initialization). There are two general 
ways in which a component can create its own address space, only 
one of which can be used before system initialization is 
complete: 


0 By means of a START command (issued by the operator or by 
the system itself via SVC 349). For example, START TCAM 
results in the creation and initialization of the TCAM 
address space. The START command can be issued only after 
system initialization is complete. Because the START 
command can be used to start any program that has a 
Procedure in SYS1.PROCLIB, component address spaces created 
via START are not included in the count of system component 
address spaces provided by the DISPLAY A,ALL command. 


e By means of JEEMB881, the system component address space 
create routine. IEEMB881 can be invoked during NIP 
initialization, during master scheduler initialization, 
during JES initialization, or after system initialization 1s 
complete. The following components use JEEMB881 to create 
their own address spaces during NIP processing, master 
scheduler initialization, or JES3 initialization: 


Program call/authorization (the PC/AUTH address space) 
System trace (the TRACE address space) 

Allocation (the ALLOCAS address space) 

Global resource serialization (the GRS address space) 
Dumping services (the DUMPSRV address space) 
Communications task Cthe CONSOLE address space) 

System Management Facility (SMF address space) 

JES3 Cthe JES3AUX address space) 


Note that the master scheduler's address space, which is the 
first address space in the system, and the primary JES address 
space are specifically created by NIP and the master scheduler, 
respectively, without use of the generalized processing provided 
by IEEMB881. The count of system component address spaces 
provided by DISPLAY A,ALL is the count of address spaces created 
via JEEMB881. Address spaces built by a component using 
ITEEMB881 are sometimes referred to as system address spaces. 


Figure 1-2 is a virtual storage map showing the master scheduler 
address space, the system address spaces, the job entry 
subsystem address spaces, the LLA address space, the SMF address 
space, the optional TCAM address space, and a user address 
space. 
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CREATION OF SYSTEM COMPONENT ADDRESS SPACES VIA IEEMB8&l 


IEEMB881 receives control from one of the following modules to ) 
build a command scheduling control block (CSCB) representing the 
request for the specified address space. 


e Allocation address space create CIEFABGI0O) - The ALLOCAS 
address space 


@ Communications task address space create routine CIEAVN700) 
- the CONSOLE address space 


e Program callZauthorization RIM CIEAVNPF5) - the PC/AUTH 
address space 


e Global resource serialization trigger address space creation 
CIEAVNP33/ISGNTASC) - the GRS address space 


@ Dumping services address space RIM CIEAVNP57) - the DUMPSRV 
address space 


e Local, global CTC initialization routine CIATINM3) - the 
JES3AUX address space 


e System trace address space create routine CIEAVETAC) - the 
TRACE address space 


e System Management Facility initialization routine CIEEMB8&20 
- the SMF address space 


When an address space 1s created via a START command, IEE0803D 
builds a CSCB. IEEMB881 fills in fields in the CSCB based on 
input passed by the caller. 


The process of creating and initializing the component address 
space represented by the CSCB is primarily a process of building : 
control blocks that: ) 


e Define the address space 
e Enable the address space to provide the component's services 
e Enable the address space to use system services 


Figure 4-15 illustrates the module flow for creating an address 
space via IEEMB88&1. The following topics describe the roles of 
the modules involved. 


DEFINING THE ADDRESS SPACE 


The modules invoked to define a system component address space 
are the same modules invoked to define any address space in the 
system. They are: 


e ITEAVEMRQ (memory request), which allocates an ASID and 
builds the ASCB for the new address space 


e IEAVEMCR (memory create) which calls IEAVGCAS to build page 
and segment tables for the new address space 


@ JEAVEMIN Cmemory initialization), which builds control 
blocks necessary for executing tasks in that address space 


@ IEAVXMIN Ccross-memory initialization), which connects the 
address space to cross memory control blocks. 


The diagram "Obtaining a New Virtual Memory" in the section 
"Command Processing" of System Logic Library describes the 
processing of these modules, including other modules called by 
them. 
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PROVIDING THE COMPONENT'S SERVICES 


The address space initialization necessary to provide a 
component's services 1s specific to that component's address 
space. IEEMB881 allows its caller to provide the name of a 
specialized initialization routine. (For address spaces created 
Via the STARI command, the procedure in SYS1.PROCLIB does any 
required specialized initialization.) The initialization 
routines provided by the components that use IEEMB88&l are: 


Program call/authorization: IEAVXMAS 
System trace: IEAVETAI 

Global resource serialization: ISGNASIM 
Dumping Services: IEAVTSAI 
Communications task: IEAVN/7O1 
Allocation: IEFHBGI1 

SMF: IEEMB8&20 

JES3: IATINXM 


With the exception of JES3, the component's initialization 
routines execute before or during master scheduler 
initialization. As a result, these routines can use only those 
system services that have completec their initialization. (This 
restriction applies to all routines that execute during master 
scheduler initialization.) Routines that require a service that 
might not be initialized can use the event notification facility 
CENF), provided it has been initialized, to wait for the 
initialization of the required service. For example, ISGNASIM 
uses ENF to wait for the availability of timer and console 
services. 





Fach initialization routine initializes its address space 
according to its component's own requirements. This includes 
creating and initializing control blocks, loading code, and 
making its data and code accessible by other address spaces via 
cross-memory instructions. 


USING SYSTEM SERVICES 


Two processes initialize address spaces to allow them to use 
system services: 


e RCT Cregion control task) processing 
e STC (started task control) processing 


RCT processing always occurs for component address spaces 
created via IEEMB&881. RCT establishes itself as the first task 
in the new address space. 


IEEPRWI2, the first STC module, always receives control but the 
STC processing that occurs depends on the action taken by the 
component's initialization routine. (When creating an address 
space via a START command, IEEPRWI2 does not call a specific 
initialization routine and all of STC processing takes place.) 
The component's initialization routine, after doing 
component-specific initialization, has these choices: 


e It can return to IEEPRWI2 to complete STC processing. If it 
does, the component must provide a procedure in SYSI1.PROCLIB 
or use IEESYSAS. 

e It can return to IJEEPRWI2 to terminate t:he address space, 


e It can enter a never-ending wait. It does not return to 
IEEPRWI2 and no further STC processing occurs. 


Address spaces differ in their ability to use system services: 
e Limited Function Address Space 
If the specific initialization routines provided by the 


components that use ITEEMB881 enter a wait state, pending 
master scheduler initialization, STC does no additional 
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address space initialization. Thus, the functions that 
component address Spaces can perform are limited. 
Components with limited function address spaces cannot: 


Allocate data sets. 

Read JCL procedures from SYS1.PROCLIB. 

Allocate a SYSOUT file through the job entry subsystem. 
Use some system services because the components 
frequently run in cross memory mode. System Macros and 
Facilities describes the restrictions placed on an 
address space that runs in cross memory mode. 


° Full Function Address Space 


If, after a component completes its own initialization, it 
returns to IEEPRWI2 and completes STC processing, the 
address space 1s fully initialized. Such an address space 
1s called a full function address space. 


The component creating a full function address space does 
not need to provide a procedure in SYS].PROCLIB. If 
specified to IEEMB&881, a common system address space 
procedure, IEESYSAS will invoke a specified program to run 
in the address space. 


For example, if a full function address space called FFA is 
to be started using module IEEMB899, the component would 
ordinarily need to supply a procedure of the following form: 


//7FFA PROC 
EXEC PGM=IEEMB899 


The procedure will be invoked as follows: 


//TEESYSAS JOB 
//7FFA EXEC IEESYSAS 
The procedure, IEESYSAS, consists of the following 
statements: 
//7TEESYSAS PROC PROG=IEFBR14 
// EXEC PGM=&PROG 


All system component address spaces are limited function address 
Spaces except the dumping services address space, DUMPSRV and 
the SMF address space. 


INITIALIZATION 
Subsystems are Specified in the IEFSSNxx members of SYS1.PARMLIB 
at system initialization. The master scheduler base 


initialization module CIEEVIPL) gives control to the subsystem 
interface initialization module CIEFJSINT). IEFJSINT calls the 
subsystem service routine CIEFJSBLD) to: 


e Build a subsystem communication vector table CSSCVT) for the 
master subsystem. 


e Build and initialize the subsystem vector table (SSVT) for 
the master subsystem. 


e Build the subsystem allocation sequence table (CSAST) for 
later use in allocating subsystem data sets. 


IEFJSINT then returns control to IEEVIPL. 

The job entry subsystem builds and initializes its own SSVT when 
the system 1S initialized. All other subsystems must do 
likewise. <A subsystem can be initialized as follows: 


e By being started (for example: START JES2) or, 
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e By having an initialization routine specified in the 
IEFSSNxx SYS1.PARMLIB record. 


Additional subsystem initialization 1s performed by module 
IEFJSIN2, which 18S invoked by IEEMB860. IEFJSIN2 calls the 
PARMLIB read routine CIEEMB878) to read each record from the 
IEFSSNxx members. All records read are passed to 

the positional parse routine (IEEMB882). IEFJSIN2 also calls 
IEFJSBLD to perform the following: 


e Link to the subsystem initialization routines specified in 
the subsystem name table. 


e Build a SSCVT for each unique subsystem specified in the 
IEFSSNxx members and link to the initialization routine if 
any 1S specified on the PARMLIB record. 


@ Build a hash table containing SSCVT addresses for use in 
processing SSI requests. 


e Rebuild the SAST if additional subsystems were defined in 
SYS1.PARMLIB. 


IEFJSBLD and IJEFJSIN2 call the subsystem initialization message 
writer CIEFJSIMW) to issue operator messages. The text of the 
messages 1S contained in IEFJSIMM. 


SYSTEM DATA SETS USED BY SYSTEM INITIALIZATION 


IPL uses the following system data set: 


e SYS].NUCLEUS, which 1S a required data set that contains the 
resident nucleus and the IPL modules. SYS1.NUCLEUS resides 
on the system residence volume. 


NIP uses the following system data sets: 


e SYS] .NUCLEUS, which is a required data set that contains the 
NIP modules. SYS1.NUCLEUS resides on the system residence 
volume. 


e SYS1.LOGREC, which is a required data set that is used for 
recording hardware, software, and I/0 errors. If not 
cataloged, SYS1.LOGREC resides on the system residence 
volume. NIPOPEN service routine performs open processing 
for SYS1.LOGREC. 


e SYS1.SVCLIB, which 1s a required data set that resides on 
the system residence volume. SYS1.SVCLIB 1s an authorized 
program library that contains type 3 and type 4 SVC routines 
used by NIP. NIPOPEN service routine performs open 
processing for SYS1.SVCLIB. 


e SYS1.LINKLIB, which 1s an authorized program library that 
contains system and user programs that are referred to by 
the XCTL, ATTACH, LINK, and LOAD macro instructions. 
SYSIL.LINKLIB also contains an assembler~language processor, 
a linkage editor, the utility programs, and the service aid 
programs. SYSI1.LINKLIB is a required data set that resides 
on a direct access volume. The LNKLST data sets are 
cataloged in the system catalog. NIPOPEN service routine 
performs open processing for SYSI1.LNKLIB and concatenates 
user-specified data sets to it to open the data sets 
specified as part of the LNKLST concatenation. 


e System catalog, which contains pointers to all cataloged 
data sets in the system control program. The system catalog 
1S a required data set that resides ona direct access 
volume. The VSAM-catalog-open RIM, IEAVNPL1, and the 
VSAM-data-set~open RIM, IEAVNPI1A, perform VSAM open 
processing for the system catalog; the VSAM-catalog-close 
Rae LEAVNPLB, performs VSAM close processing for the systém 
catalog. 
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0 SYS1.PARMLIB, which contains both IBM-supplied and 
user-supplied lists of system parameter values that serve as 
input to system initialization. SYS1.PARMLIB is a required 
data set that resides on a direct access volume. If it does 
not reside on the system residence volume, SYS1.PARMLIB is 
cataloged in the system catalog. The NIPOPEN service 
routine performs open processing for SYS1.PARMLIB. 


@ Page data sets, which are required VSAM data sets that 
reside on direct access volumes and are cataloged in the 
system catalog. The ASM RIMs, IEAVNPOG/ILRASRIM and 
IEAVNPLG/ILRASRM1, use an ASM open routine CILROPSOO) to 
perform open processing for the page data sets. 


0 Swap data sets, which are optional VSAM data sets that 
reside on direct access volumes and are cataloged in the 
system catalog. The ASM RIM, IEAVNP14/ILRASRM1, uses an ASM 
open routine CILROPSOO) to perform open processing for the 
swap data sets. 


0 SYS1.LPALIB, which contains modules that are loaded into the 
pageable link pack area. The contents Supervisor RIM, 
IEAVNPO5, loads modules from SYS1.LPALIB and the 
user-specified data sets that are concatenated to 
SYS1.LPALIB Cthe LPALST). SYS1.LPALIB is required only for 
cold start system initialization. The LPALST data sets 
reside on direct access volumes and must be cataloged in the 
system catalog. 


0 SYS1.DUMPxx, which 1S an optional data set that contains 
system dumps used to record areas of virtual storage in case 
of system task failures. SYS1.DUMPxx resides on either a 
direct access volume or a magnetic tape volume. It is 
cataloged only if it resides on a direct access volume. If 
the installation has specified dump data sets using the DUMP 
system parameter, the recovery termination management SVC 
dump RIM, IEAVTSDD, builds a dump data set queue (SDDSQ) to 
contain the name CDASD) or unit address (tape) of available 
SYS1.DUMPxx data sets. 


Master scheduler initialization uses the following system data 
sets: 


0 SYS1.LQGREC, which contains information relating to the 
current system initialization. During master scheduler 
initialization, the missing-interrupt handler issues an 
initialization record for this data set. 


0 SYS].LINKLIB Cat the head of the LNKLST concatenation), 
which contains some of the master scheduler initialization 
modules. The member MSTJCLxx contains the card images for 
the JCL that defines data sets for the system and for TSQ. 


e SYS1.STGINDEX, which contains ASM mapping tables for the 
pages of virtual input/output (VIO) data sets that must be 
Saved across job steps and between system initializations. 
SYS1.STGINDEX is a data set that resides ona direct access 
volume. SYS1.STGINDEX is cataloged in the system catalog. 
An ASM module CILRTMIO0) opens SYSI]1.STGINDEX during master 
scheduler initialization. 


@ SYSI1.MANn, which 1s the SMF recording data set. During SMF 
initialization, the SMF writer opens the data sets specified 
in PARMLIB member SMFPRMx~x. 


e One or more RACF data set(s) Con systems with the RACF 
Program product, Program No. 5740-XXH), which contain 
descriptions of each RACF-defined user of resource. They 
are used by RACF for user verification and authorization 


checking. For more information about RACF, see the Resource 


Access Control Facility CRACF) General Information Manual. 


The following data sets are defined in the MSTJCLOO member of 
SYS1.LINKLIB CMSTJCLOO0, supplied by IBM, is the default master 
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JCL member). These data sets are available during the last part 
of master scheduler initialization. 


0 SYS1.PROCLIB, which contains standard JCL procedures for the 
system. 


0 SYS1.PARMLIB, which contains various lists of system 
parameters. 


° SYS1.UADS, which 1s a user attribute data set that contains 
a description of each TSO user. It 1s used by LOGON 
scheduling to verify LOGON commands. 


e SYS1.BRODCAST, which contains the broadcast messages for 
TSQ. 


e Internal readers, which are two internal reader data sets 
CSTCINRDR and TSOINRDR) that are defined by the master 
scheduler’s JCL. They are the means by which started task 
control passes JCL to a job entry subsystem. 


Dump Analysis and Elimination (CDAE) uses the following data set 
after initialization: 


° SYS1.DAE, which contains records describing previous 
Problems that have occurred on the system. These problems 
resulted in either an SVC dump or an SYSMDUMP dump being 
requested. The data set can be created after SYSGEN, using 
IEFBR14, which allocates space. The DAEALLOC member of 
SYS1.SAMPLIB contains JCL that an installation can execute 
to create the SYS1.DAE data set. 


ERROR HANDLING DURING SYSTEM INITIALIZATION 


Before system recovery routines are available, IPL and NIP 
provide diagnostic support for hardware and software errors. 


There are certain program checks that IPL expects to experience 
and recover from. If, however, an unexpected program check 
occurs, IPL places the system ina wait state with a code of 
X'O019*. 


NIP attempts to detect unrecoverable system errors that occur 
during NIP processing and diagnose the errors with appropriate 
messages or wait state codes. 

To detect errors, NIP provides trap routines that stop the 
initialization process at the time the error occurs. NIP traps 
the following unrecoverable system errors: 


Requests for ABEND CSVC 13) 

Machine checks 

Requests for entry to recovery termination management 
Unexpected program checks 

Requests for type 3 and type 4 SVC routines prior to the 
link pack area being available 


NIP provides diagnostic information about the above errors by 
placing appropriate wait state codes in the wait state PSN. 


NIP attempts to initialize the system regardless of errors made 
by the installation in specifying system parameters. If NIP 
encounters an incorrectly specified system parameter, it prompts 
the operator for a correct value. If the operator cannot 
correct the specification, the operator may specify that NIP use 
system defaults. Most parameters have default values either in 
a member of SYS1.PARMLIB or in NIP code. After NIP processes 
the operator's response to the SPECIFY SYSTEM PARAMETERS 
message, the SYS1.PARMLIB defaults are no longer available. 


In cases when defaults do not exist, the operator may not cancel 
the parameter. 
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To aid recovery if an I/0 error occurs during paging, ASM 
creates two copies of the pageable common area when a duplex 
Page data set is provided. (The pageable common area contains 
the pageable link pack area and its modifications, and the 
common service area.) 


ASM places one copy on the PLPA or common page data set and the 
other on the duplex data set. If the copy on the PLPA or common 
page data set cannot be read ASM attempts to read the copy on 
the duplex data set. If successful, the system continues 
processing without interruption. 


If the mass storage system communicator (MSSC) cannot initialize 
at NIP or master scheduler initialization time, two messages are 
issued to the operator. One message indicates the reason MSSC 
cannot initialize. The other requires that the operator 
respond, requesting that the initialization continue without the 
mass storage system. 


If master scheduler initialization fails or abnormally 
terminates, an ESTAE routine performs error processing and, in 
some cases, retry processing. If master scheduler 
initialization cannot continue, the system will enter a wait 
state after error messages are issued. (Error messages can be 
issued only if the communications task has been initialized. ) 


USER CONTROL OF INITIALIZATION 


TYPES OF IPL 


Before system initialization, the installation customizes the 
control program to both the data processing requirements and the 
machine configuration of the installation. The system 
generation process obtains standard and optional IBM-supplied 
components from distribution libraries, then combines them with 


user-written components from user data sets. The system 
generation process places the resultant system control program 
in system data sets on system volumes. During Input/Output 


generation CIOGEN) the installation defines the devices through 
the I/O Configuration Program. The MVS Configuration Program 
defines these devices to the system and creates the EDT table 
during EDTGEN. When these phases are complete, the system is 
ready for initialization. 


During system initialization, the installation can affect 
initialization processing by selecting the type of IPL, 
specifying system parameters, and communicating with the system 
through the operator interface. 


Page data sets are opened and initialized according to the type 
of IPL - cold, quick, or warm: 


0 Cold Start: Any IPL that loads Cor reloads) the PLPA, and 
does not preserve VIO data set pages. The first IPL after 
system generation (sysgen) is always a cold start because 
the PLPA is initially loaded. Subsequent IPLsS are cold 
starts when the PLPA is reloaded either to alter its 
contents or to restore its contents if they were destroyed. 


° Quick Start: Any IPL that does not reload the PLPA and does 
not preserve VIO data set pages. Instead of reloading the 
PLPA, NIP resets the page and segment tables to match the 
last-created PLPA. 


e Warm Start: Any IPL that does not reload the PLPA and does 
preserve journaled VIO data set pages. 
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THE FIRST IPL AFTER SYSTEM GENERATION: At the first IPL after 
sysgen, NIP automatically loads the PLPA from the LPALST data 
sets. The page data sets for this IPL are those named in 
SYS1.PARMLIB member IEASYSO0O0O plus any specified by the operator. 
These page data sets are those that were specified in sysgen 
DATASET macros that contained the PAGEDSN keyword or the 
DUPLEXDS,NAME Keyword combination. The operator need not enter 
the CLPA (€create link pack area) parameter in response to the 
SPECIFY SYSTEM PARAMETERS message to load the PLPA. NIP does it 
automatically. 


After the first IPL, the SYS1.LOGREC initialization routine, 
IFCDIPO0, must be run to initialize SYS].LOGREC. This routine 
must also be run whenever SYS1.LOGREC is reallocated. 


AN IPL AT WHICH THE PLPA IS RELOABED: The PLPA needs to be 
loaded three times: 


@ At the first IPL after sysgen, when NIP loads it 
automatically. 


e At an IPL after the installation has added or modified one 
or more modules in SYS1.LPALIB, or in an LPALST data set 
concatenated to SYS]1.LPALIB, has tested the alteration, and 
now wants to put the replacement module(s) in the PLPA. 


@ At an IPL after the PLPA page data set has been damaged (and 
is therefore unusable and its contents must be restored). 


To reload the PLPA from LPALST, the operator enters CLPA Ccreate 
link pack area) as one of his responses to the SPECIFY SYSTEM 
PARAMETERS message. Reloading the PLPA should not be a common 
occurrence. It should be done only when necessary because the 
associated I/0 slows down the IPL and because previously 
existing VIO data set pages are deleted. (For further 
information on the loading of the PLPA, see the CLPA parameter 
in the description of the IEASYSxx parmlib member. ) 


AN IPL AFTER POWER-UP: The IPL performed after power-up is 
called a quick start, because the PLPA from the previous IPL can 
be used without reloading from LPALST. For a quick start, the 
CVIO system parameter 1s specified; VIO data set pages are 
purged, page data sets added (optionally reserved for non-VIO 
paging), and swap data sets replaced. The operator, or the 
IEASYSxx member of SYS1.PARMLIB, can add additional page data 
sets by specifying the PAGE parameter (with or without 
specifying the NONVIO system parameter) and can replace swap 
data sets by specifying the SWAP parameter. 


AN IPL AFTER A SYSTEM CRASH: Provided that the operator does 
not enter the CLPA or CVIO system parameters, the operator can 
warm start the system after a system crash. Existing journaled 
VIO data set pages are retained by the auxiliary storage manager 
for continued use. The specified parmlib parameter list 
CIEASYSxx) would not include the CVIO or CLPA system parameters. 


Any definitions of existing page data sets as non-VIO local page 
data sets are preserved. Also the operator can define a local 
page data set that previously was used for VIO paging as a 
non-VIO local page data set. During system operation, the VIO 
Pages on the newly-designated non-VIO local page data set will 
migrate to any local page data set used for VIO paging. An 
installation can remove a local page data set that was 
designated on the previous IPL as a non-VIO local paging data 
set. Removing a local page data set prior to a warm start 
requires that the local page data set contain no VIO pages. If 
the local page data set contains VIO pages, then the warm start 
is changed into a quick start. 
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System parameters provide the installation with the means to 
tailor or tune a system to meet the installation's requirements. 
Following is a brief description of the system parameters: 


APF indicates the members CIEAAPFxx) of SYS1.PARMLIB that 
contain authorized data set names. 


APG specifies the number of the automatic priority group for 
use by the system resources manager (CSRM), unless nullified 
by the IPS. 


CLOCK indicates the member (CCLOCKxx) of SYS1.PARMLIB which 
prompts the op2rator to initialized the TOD clock and 
specifies the difference between the local time and GMT. 


CLPA indicates that NIP should load the pageable link pack 
area with the modules contained in the LPALST data sets. 


CMB specifies the I/0 device classes for which measurement 
data is to be collected, in addition to the DASD and tape 
device classes. 


CMD indicates the member or members CCOMMNDxx) of 
SYS1.PARMLIB that contain commands to be issued 
automatically during master scheduler initialization. 


CON indicates the CONSOLxx member of SYS].PARMLIB that 
contains the multiple console support (MCS) console 
definition and various communication task parameters. 


CSA specifies the number of 1K blocks of virtual storage to 
be reserved for the common service area (CSA) and extended 
CSA CECSA). 


CVIO indicates that the pages of previously-created virtual 
input/output CVIO) data sets should be deleted from external 
Page storage 


DUMP specifies whether SYS]1.DUMP data sets for SVC dump 
reside on direct access or tape devices. 


DUPLEX specifies the duplex paging data set to be used. The 
DUPLEX parameter is optional and should be used only if CLPA 
is specified. For quick and warm starts, a duplex paging 
data set from the previous CLPA IPL is used; the DUPLEX 
parameter iS ignored. 


FIX indicates one or more members CIEAFIXxx) of SYS1.PARMLIB 
that contain names of modules to be placed in the fixed link 
pack area 


GRS indicates whether the system being initialized is to 
start a global resource serialization complex, join an 
existing global resource serialization complex, or not be 
part of a complex. 


GRSCNF indicates the member (CGRSCNFxx) of SYS]1.PARMLIB that 
contains the information that describes the systems to be 
part of a global resource serialization complex. 


GRSRNL indicates one or more members CGRSRNLxx) of 
SYS]1.PARMLIB that contain the resource name lists (RNLS) 
used by the global resource serialization complex. 


ICS indicates the member CIEAICSxx) of SYS].PARMLIB that 
contains the installation control specification for the 
system resources manager (SRM). 


IOS indicates the member CIECIOSxx) of SYS1.PARMLIB that 
contains the IOS options for the missing interrupt handler 
CMIH) and for hot I/O CHOTIO). 


1-20 MVS/XA System Init Logic LY28-1200-G@ (€c) Copyright IBM Corp. 1982, 1987 


"Restricted Materials of IBM" 
Licensed Materials ~ Property of IBM 


IPS indicates the member CIEAIPSxx) of SYS1.PARMLIB that 
contains the installation performance specification CIPS) 
for the system resources manager (SRM). 


LNK indicates one or more members (CLNKLSTxx) of SYS1.PARMLIB 
that contain names of data sets to be concatenated to 
SYS1.LINKLIB. 


LNKAUTH specifies that the data sets in the LNKLST 
concatenation are all to be treated as APF authorized, or 
are only to be treated as APF authorized if specifically 
named in the APF table. 


LOGCLS specifies the JES output class for the log data sets. 


LOGLMT specifies the maximum number of messages for a log 
data set. 


LPA indicates one or more members (CLPALSTxx) of SYS1.PARMLIB 
that contain the names of data sets to be concatenated to 
SYS1.LPALIB. 


MAXUSER specifies the maximum number of address spaces that 
may be created under normal conditions. When the system is 
heavily used, the value specified on the RSVSTRI parameter 
may permit additional started tasks. 


MLPA indicates one or more members CIEALPAxx) of 
SYS]1.PARMLIB that contain names of modules to be placed in 
the modified link pack area (MLPA). 


MSTRJCL indicates the member CMSTJCLxx) of SYS1.LINKLIB 
that contains the JCL for starting the master scheduler 
address space. 


NONVIO specifies the names of local paging data sets that 
are not to receive VIO pages when the directed VIO function 
1s active. 


OPI indicates whether the operator may override parameters 
in IEASYSx~x. 


OPT indicates a member CIEAOPTxx) of SYS1.PARMLIB that 
contains the tuning parameters for the SRM. 


PAGE specifies the names of page data sets to be used with 
the exception of the duplex paging data set. See the DUPLEX 
parameter listed earlier. 


PAGTOTL specifies the total number of page and swap data 
sets ae pL be made available to the system for the life 
‘e) e IPL. 


PAK indicates the members CIEAPAKxx) of SYSI1.PARMLIB that 
contain lists of modules to be packed together in the PLPA. 


PURGE specifies the demounting of mass storage volumes that 
had been specified at the previous IPL ona specific 
processor. If PURGE is issued during IPL and the IPL fails, 
PURGE must be issued again during re-IPL or the mass storage 
volume inventory will be inaccurate. (For more information, 


a Hass storage System Extensions Logic: MSS Communicator 
SSC). 


RDE specifies the inclusion of the reliablity data extractor 
feature. RDE also controls the "Enter IPL reason" prompt. 
For more information, see SYS]1.LOGREC Error Recording. 


REAL specifies the maximum amount of 1K units of real 
storage that can be allocated for V=R jobs. 


RER specifies that the reduced error recover procedures for 
magnetic tape are to be used. This must be requested in the 
OPTCD parameter of a data definition (DD) statement or in 
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the DCB macro instruction. If RER is not specified, the 
system ignores all requests for reduced errror recovery. 


e RSU specifies the number of processor storage units that are 
required for storage reconfiguration. The frames in these 
storage units will be designated as the nonpreferred area; 
they are not to be used for long-term storage if preferred 
area storage iS available. 


@ RSVNONR specifies the number of entries in the address space 
vector table CASVT) reserved for replacing entries marked 
non-reusable for the duration of the IPL. 


e RSVSTRT specifies the number of entries in the address space 
vector table CASVT) reserved for address spaces created in 
response to a START command. This helps avoid a re-IPL when 
there 1S no available entry for a critical address space. 


e SCH indicates the member (SCHEDxx) of SYS].PARMLIB that 
contains master scheduler parameters. 


e SMF indicates the member CSMFPRMxx) of SYS]1.PARMLIB that 
contains SMF parameters. 


0 SQA specifies the number of 64K blocks of the virtual system 
queue area (SQA) and extended SQA to be created during NIP 
initialization in addition to the initial three blocks of 
SQA and three blocks of extended SQA. 


e SSN indicates one or more members CIEFSSNxx) of SYS1.PARMLIB 
that define subsystems to the system during master scheduler 
initialization. 


e SVC indicates the member CIEASVCxx) that contains 
installation-defined SVCs. 


e SWAP specifies the names of swap data sets to be used. 


e SYSNAME provides the name by which a system is Known to the 
global resource serialization complex. 


@ SYSP indicates one or more system parameter lists CIEASYSxx) 
in SYS]1.PARMLIB that are to be used by NIP in addition to 
IEASYSOO. 


e VAL indicates one or more members (CVATLSTxx) of SYS1.PARMLIB 
that contain attributes of direct access volumes. 


@e VRREGN specifies the default real storage region size in 1K 
units for V=R jobs that do not specify a region size in 
their JCL. 


NIP and master scheduler initialization routines process the 
system parameters during system initialization processing. 
Figure 1-3 shows the relationship among the system parameters, 
the system components they affect, and the initialization 
modules that process the parameters. 
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System Parameter 


System Component Affected 


NIP Object Module 


APF Contents supervisor ITEAVNPAS 

APG System resources manager IEAVNP1O 

CLOCK Master scheduler IEAVNP20 

CLPA Contents supervisor and ITEAVNPOS5 
Auxiliary storage management ILRASRIM, ILRASRMI1 

CMB System resource management ITEAVNP1F 

CMD Master scheduler initialization ITEAVNP13 

CON Communications task IEAVNPAIL 

CSA Virtual storage management IEAVNPO08 

CVIO Auxiliary storage management ILRASRIM, ILRASRM1 
Auxiliary storage management ILRITMIOO 

DUMP Recovery termination management IEAVTSDD 

DUPLEX Auxiliary storage management ILRASRIM 

FIX Contents supervisor IEAVNPO5 

GRS Global resource Serialization ISGNCBIM, ISGNGRSP 

GRSCNF Global resource Serialization ISGJPARM 

GRSRNL Global resource serialization ISGNRNLP 

ICS System resources manager ITEAVNP10 

10S I“70 supervisor IEAVNPF2 

IPS System resources manager ITEAVNP1O 

LNK NIP ITEAVNPO3 

i_NKAUTH NIP ITEAVNPO3 

LOGCLS System log TEAVNP13 

LOGLMT System log TEAVNP13 

LPA Contents supervisor IEAVNPOS5 

MAXUSER Supervisor control IEAVNPO9 

MLPA Contents supervisor IEAVNPOS5 

MSTRJCL Master scheduler initialization IEAVNP13 

NONVIO Auxiliary storage management ILRASRIM, ILRASRM1 

OPI NIP ITEAVNPO3 

OPT System resources manager IEAVNP10 

PAGE Auxiliary storage management ILRASRIM 

PAGTOTL Auxiliary storage management ILRASRIM 

PAK Contents supervisor IEAVNPC5 

PURGE? Mass storage system communicator ITEAVNP19 

RDE Data management TEAVNP16 

REAL Real storage management IEAVNPD8&, IEAVNPE8& 

RER Data management ITEAVNP16 

RSU Real storage management ITEAVNPD8 

RSVNONR Supervisor control ITEAVNPOS9 

RSVSTRT Supervisor control TEAVNPO9 

SCH Master scheduler ITEANVP18 

SMF System management facilities ITEAVNP13 

SQA Vartual storage management IEAVNPA8 

SSN Subsystem interface ITEAVNP13 

SVC Supervisor Control 

SWAP Auxiliary storage management ILRASRIM 

SYSNAME Global resource Serialization ISGNCBIM 

SYSP NIP ITEAVNPO3 

VAL Volume attribute processing IEAVAPOO 

VRREGN Virtual storage management IEAVNP D8 

Figure 1-3. Relationship Among System Parameters, System Components, and NIP 


Processing Modules 


For information on PURGE command processing, refer to Mass 
Storage System Extensions Logic (MSSC). 
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System parameters come from two sources: 


e Using IEBUPDTE, the installation specifies system parameters 
in ITEASYSxx members of SYS1].PARMLIB. If the installation 
places parameters in an IEASYSxx member, the operator 
indicates which member contains the parameters by using the 
SYSP= parameter in response to the SPECIFY SYSTEM PARAMETERS 
message. By using an IEASYSxx member for system parameters, 
the installation reduces the amount of operator interaction 
during NIP processing. For information about determining 
system parameter values and entering system parameters in 
SYS1.PARMLIB, refer to Initialization and Tuning. NIP 
merges parameters from IEASYS00O with parameters specified in 
alternate IEASYSxx members. Parameter values from the last 
IEASYSxx member that NIP reads override previous IEASYSxx 
and IEASYS0O0 values for those parameters. 


@ In response to the SPECIFY SYSTEM PARAMETERS message issued 
by NIP, the operator may specify system parameters. An 
operator-entered parameter overrides the same parameter 
specified in IEASYS0OO0O or IEASYSxx, except for: 


om A parameter for which operator intervention is 
prohibited COPI=NO). 


_— The PAGE parameter; NIP adds the data set names entered 
by the operator to the data set names specified in 
either IEASYS0O0O or IEASYSxx. 


OPERATOR INTERFACE DURING INITIALIZATION 


IPL permits the operator to specify a nucleus other than the 
system-assigned nucleus CIEANUCO1). IPL also allows selection 
of an alternate I/0 configuration. For details on the procedure 


involved, see Qperations: System Commands. 


NIP establishes operator communications immediately after it 2 
initializes the master console. 


l. NIP issues message 'IEA1LO1A SPECIFY SYSTEM PARAMETERS'. The 
operator's reply indicates one of the following: 


0 NIP should use the default list of system parameters 
CIEASYSO0) in SYS1.PARMLIB. 


e NIP should use the list of system parameters CIEASYSxx) 
in SYS1.PARMLIB. 


e NIP should cancel a parameter value specified in 
IEASYSxx and use the system default if one exists. 


@ NIP should use new system parameter values specified in 
the reply, overriding the values specified in IEASYSxx. 


2. NIP issues message 'IEA437A SPECIFY MASTER CATALOG 
PARAMETER. The operator's reply indicates one of the 
following: 


e NIP should use the default member SYSCATLG in 
SYS1.NUCLEUS to find the master catalog. 


e NIP should use an alternate member SYSCATnn in 
SYS1.NUCLEUS to find the master catalog. 


The operator's procedures for specifying an alternate 
master catalog is described in Operations: System 
Commands 


At system generation time, the installation uses the OPI 

Parameter to indicate whether the operator may override system ° 
parameters in IEASYSxx members of SYS]1.PARMLIB. The 

installation may restrict operator intervention for individual 

system parameters in the IEASYSxx member or for the entire set 
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of system parameters. However, if a parameter in an IEASYSxx 
member iS in error and the installation has restricted operator 
intervention for the parameter, NIP prompts the operator for a 
correct parameter value regardless of the installation's 
restriction. The procedure for restricting operator 
intervention during NIP is described in Initialization and 


Tuning 


When IEAVNIPM calls IEAVNP20, TOD clock initialization allows 
the operator to enter the Greenwich mean time, the local time, 
and the local date; these are required to set the TOD clock(s), 
and the local time and date for the system. When a TOD clock is 
ready to be set to the correct time, TOD clock initialization 
requests that the operator enable the clock security switch. 


Note: In the reply used to set the TOD clock or the local time 
and date, the operator can choose to specify a new value for the 
IPS parameter. The IPS parameter indicates the member of 
SYS1.PARMLIB that contains the installation performance 
specification for the system resource manager (SRM). 


During master scheduler initialization, SMF initialization 
allows the operator to enter correct SMF parameters to replace 
those parameters that are invalid or missing. 
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REAL AND VIRTUAL STORAGE DURING INITIALIZATION 


The initial program loader CIEAIPL00) is a stand-alone program 
consisting of three IPL records. It resides on cylinder 0, 
track 0 of the system residence volume. In preparation for 
loading IEAIPLO0, the operator mounts the system residence 
volume ona direct access device. Then the operator initiates 
LOAD processing. In response to this initiation the hardware 
reads the first IPL record into real storage locations 0 through 
23 (see Figure 1-4). The doubleword beginning at location 8 is 
a read CCW (channel command word) that causes the loading of the 
second IPL record at a real storage address higher than the size 
of the IPL text record. The transfer-in-channel CTIC) command 
at location 16 in the first record causes control to pass to the 
second record. 


The second IPL record is a chain of CCWs that cause the fourth 
record, containing the IPL text, to be read into real storage 
beginning at location 0. This IPL text record overlays the 
first record. When the last CCW in the second record has been 
executed, the processor loads the doubleword beginning at 
location 0 as a new PSW, thus passing control to the IPL text 
Cfourth record). 


System Residence Volume 


Real Storage 















High 
Record 4 (IPL text) 
Record 2 (JPL) 
Record 3 (volume label) 
Recard 4 
(IPL text) 
Record 2 (IPL) 
Recard t (PL) 0 





Record t (IPL) 


Figure 1-4. Real Storage During IPL Loading 


The following storage maps describe virtual storage during the 
initialization process and indicate the modules that allocate 
storage for the major system areas and begin to initialize these 
areas. Figure 1-5 describes virtual storage at the conclusion 
of the IPL phase of initialization. Figure 1-6 describes 
virtual storage immediately before the NIP control program, 
IEAVNIPM, begins to execute. Figure 1-7 describes virtual 
storage at the conclusion of the NIP phase of initialization. 


For other maps of virtual storage during initialization, see 
Figure 1-2, which shows the virtual storage layout for multiple 
address spaces, and Figure 5-3, which shows the virtual storage 
on exit from IEAIPLO4. 
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Figure 1-5. Virtual Storage on Exit from IEAIPL99 
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Figure 1-6. Virtual Storage on Exit from IEAVNIPO 
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SECTION 2. DATA AREAS 


IPL Data Areas 


NIP Data Areas 


This section briefly describes the data areas used during IPL 
and NIP 


The following Microfiche publications contain more information 
on the data areas used during IPL and NIP processing. 


Data Areas 


° LYB8-1191 for MVS/SP V2 JES2 
e LYB8-1195 for MVS/SP V2 JES3 


Data Area Usage Table 


° LYB8-1193 for MVS/SP V2 JES2 
° LYB8-1197 for MVS/SP V2 JES3 


Symbol Usage Table 


° LYB8-1192 for MVS/SP V2 JES2 
° LYB8-1196 for MVS/SP V2 JES3 


DATA AREA DESCRIPTIONS 


This section includes brief descriptions of the following data 
areas: 


IPL vector table CIVT) 

Nucleus map CNUCMAP) 

Message queue element (MQE) 
Message queue header (MQH) 
Nucleus load list element (CNLLE)D 


Extended quick start record CEQSRD) 
NIP parameter address table CPARMTAB) 
NIP parameter area CNIPPAREA) 

NIP system parameter queue entry (SPE) 
NIP vector table CNVT) 

NIPMOUNT parameter list 

NIPOPEN parameter list 

NIPNTO message header 

NIPNTOR parameter list 

Quick start record (QSRCD) 

Quick start record extension CXQSRD) 


Master Scheduler Data Areas 


Master trace table (MTT) 


The layouts of the above data areas, except the system parameter 


queue entry are in the publication MVS/XA Debugging Handbook. 


The layout of the system parameter queue is in this section. 
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IPL Vector Table (IVT) 
POINTED TO BY: Register 1 on entry to IRIMS and IEAVNIPO. ) 
MAPPING MACRO: IHAIVT 


USE: Used for communication among the IRIMs, IEAIPLOO, and 
IEAVNIPO. 


LENGTH: 336 bytes 


Nucleus Map (NUCMAP) 
POINTED TO BY: CVTNUCMP. 
MAPPING MACRO INSTRUCTION: IEANUCMP. 
USE: Describes all DAT-on nucleus csects and entry points. For 
details of format and order, see Diagram 3: NUCMAP Creation in 


Section 2. 
LENGTH: Length of each entry (4 bytes) x number of entry points 
in the nucleus. 
Message Queue Element (MQE) 
POINTED TO BY: MQHIST and MQHNTH 
MAPPING MACRO: IHAMQE 
USE: Contains messages issued during IPL 
LENGTH: 10 bytes + message length. Maximum messaga length is 
125 bytes. J 
Message Queue Header (MQH) 
POINTED TO BY: IVTMQHP during IPL and NVTMQHP during NIP 
MAPPING MACRO: IHAMQH 
USE: MQH is the message header for the IPL message queue. 


LENGTH: 12 bytes 


Nucleus Load List Element (NLLE) 
POINTED TO BY: IVTNLLEF, IVTNLLEL and NLLNEXT 
MAPPING MACRO: IEANLLE 


USE: Contains the SYS]1.NUCLEUS member name of the module and 
the work area for the nucleus loading amd mapping routine. 


LENGTH: 


Extended Quick Start Record (EQSRD) 


POINTED TO BY: Field NVTQSBUF + length of QSRCD (the EQSRD is 
contiguous to the QSRCD). 


MAPPING MACRO: ILREQSRD. 


USE: Contains information about the extended pageable link pack 
area; used for quick start and warm start initialization. ) 


LENGTH: 8192 bytes. 
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NIP Console Table (CIEAVNCTxx) 


POINTED TO BY: 

MAPPING MACRO: 

USE: Built by MVSCP. Lists terminals that NIP is allowed to 
use as consoles. NIP uses this list to find a NIP console, xx. 
The "xx™ is determined by the load parameter from SYS1.PARMLIB 
member CONSOLxx. The default is "00." 


LENGTH: 


NIP Parameter Address Table (PARMTAB) 


POINTED TO BY: Field NVTPTAB in the NVT. 
MAPPING MACRO: IEAPPNIP. 
USE: Contains addresses of system parameter values. 


LENGTH: 


NIP Parameter Area (NIPPAREA) 


POINTED TO BY: Field NVTPAREA in the NVT. 

MAPPING MACRO: IEAPPNIP. 

USE: Contains workarea for reading SYS1.PARMLIB members. 
LENGTH: 526 bytes. 


NIP System Parameter Queue Entry (SPE) 


POINTED TO BY: The first SPE is in field NVTSPE of the NVT. 
MAPPING MACRO: None. 

USE: Tracks SQA buffers that contain WTOR replies. 

LENGTH: Variable 


NIP Vector Table (NVT) 


POINTED TO BY: Register 2 CRNVT). 
MAPPING MACRO: =IHANVT. 


USE: Used for communication among NIP modules; contains 
information such as NIP wait state codes, pointers to nucleus 
control blocks, storage allocation values, NIP save areas, 
system status flags, PSW descriptors, and addresses of IEAVNIPM 
service routines. 


LENGTH: 


NIPMOUNT Parameter List 


LY28-1200-4 


POINTED TO BY: Register 1 CRPARM). 
MAPPING MACRO INSTRUCTIGN: IEAPMNIP TYPE=MOUNTPL. 
USE: Passes information to the NIPMOUNT service routine. 


LENGTH: 
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NIPOPEN Parameter List 
POINTED TO BY: Register 1 CRPARM). 
MAPPING MACRO INSTRUCTION: IEAPMNIP TYPE=OPENPL. 
USE: Passes information to the NIPOPEN service routine. 


LENGTH: 


NIPWTO Message Header 


POINTED TO BY: Register 1 CRPARM) or, if NIPWNTOR request, 
NIPWNTOR parameter list. 


MAPPING MACRO INSTRUCTION: IEAPMNIP TYPE=HEADER. 
USE: Passes information to the NIPWTO service routine. 


LENGTH: 


NIPWTOR Parameter List 
POINTED TO BY: Register 1 CRPARM). 
MAPPING MACRO INSTRUCTION: IEAPMNIP TYPE=PLIST. 
USE: Passes information to the NIPWTOR service routine. 


LENGTH: 16 bytes. 


Quick Start Record (QSRCD) 
POINTED TO BY: Field NVTQSBUF in the NVT. 
MAPPING MACRO: ILRQSRCD. 


USE: Contains information about the pageable link pack area; 
used for quick and warm start initialization. 


LENGTH: 8192 bytes. 


Quick Start Record Extension (XQSRD) 
POINTED TO BY: QSRXQSR in the QSRCD. 
MAPPING MACRO: ILRXQSRD. 


USE: For quick and warm start initialization, contains PLPA 
slot information that must be save across IPLs. 


LENGTH: 4096 bytes. 


Master Trace Table (MTT) 
POINTED TO BY: Field BAMTTBL in the master scheduler resident 
data area CMSRDA) control block. This control block is located 
in the nucleus and it 18S pointed to by field CVTMSER in the CVT. 
MAPPING MACRO: IEE2ZB806 
USE: Contains messages that are eligible for hard copy. The 
table 1S a wraparound table that is filled from the end to the 
beginning. 


LENGTH: 16K to 999K. 
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DIAGNOSTIC AIDS 


SECTION 3. 


LY28-1200-4 


This section contains information that can be used to diagnose 
problems in system initialization programs: 


TCB structure — This section gives a visual representation 
of the tasks that are attached by the master scheduler 
initialization and remain as permanent system tasks. 


IPL diagnostic techniques — This section describes some of 
the causes of disabled wait states. 


IEAVNIPO diagnostic trap routines — This section describes 
the routines that trap hardware and software errors during 
ITEAVNIPO, with the wait state codes used to indicate a 
particular error. 


ITEAVNIPM diagnostic trap routines — This section describes 
the routines that trap hardware and software errors before 
the system recovery routines are available. It describes 
the actions taken at the time of the error, the wait state 
code if NIP terminates, and the values to which the trap 
routines are reset at the end of NIP processing. 


NIP Wait State Code X'64%' -— This section describes the 
conditions that cause a wait state code X'64' with a reason 
code of 5 or 9. 


Additional diagnostic information can be found in the following 


publications: 
e Message Library: System Messages, which contains message 


IDs and an explanation about why the message was produced. 


Message Library: System Codes, which contains wait state 


codes and an explanation why they are produced. 


System Programming Library: Diagnostic Techniques, which 


contains methods for diagnosing system problems. 
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Figure 3-1. TCB Structure in the Master Scheduler Region Following System Initialization 
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IPL DIAGNOSTIC TRAP TECHNIQUES 


LY28-1200-4 


The IPL component contains no explicit recovery or retry 
routines for program errors. Detection of a software error 
during IPL leaves no reasonable alternative but to enter a 
disabled wait state. 


IPL does try to recover from a class of correctable I/0 errors. 
Uncorrectable I/O errors, however, cause a disabled wait state. 


The contents of the old PSWs are particularly useful for 
diagnosis of IPL errors because the wait state is entered so 
soon after the error occurs. A stand-alone dump is also 
required whenever the cause of a wait state cannot be determined 
from the operator's console. 


There is other diagnostic information available during IPL in 
the following real storage locations: 


Loc X'l10* Pointer to the frame queue (list of good frames) 

Loc X*'14' Pointer to the IPL diagnostic area 

Loc X'GC" Pointer to the failing CCW, if a unit check occurred 
Loc X'54" Four sense bytes that describe the unit check 


The IPL diagnostic area, pointed to by real location X'14", has 
the following format: 


Hex Offset Length Description 
00 


+ 8 Name of the module most recently given control 

+ 08 8 Name of SYSI1.NUCLEUS member that IPL most 
recently tried to find 

+ 10 G Pointer to the start of the SVC stack 

+ 14 G Pointer to the current element in the SVC stack 

+ 18 G Pointer to the address of the location just 
beyoi:d the end of the SVC stack 

+ 1C G Length of an SVC stack element 

+ 20 4G Virtual address of the IRIM area 

+ 24 G Real address of the IRIM area 

+ 28 G Virtual address of the IVT 

+ 2C q Real address of the IVT 

+ 30 G Real address of the most recent SCPINFO 
response 

+ 34 G Address of the subchannel information block 

+ 38 G Address of the sense data (meaningful only 


after a unit check) 


The SVC stack area 1S used to save status on an SVC interrupt. 
Each entry, which is 32 bytes long, contains: 


e The SVC old PSW at the time of interrupt 
O The SVC interruption code (SVC number) 
e The contents of registers 1-5 at the time of interrupt 


There 1S a pointer se to the top stack element, the entry 
currently in use. This pointer must be updated (by adding the 
length of an entry) before the status for a new interrupt can be 
stored on the stack. While an SVC routine is processing, the 
pointer indicates the stack entry that contains the saved status 
of the requestor of this SVC. An exception to this general 
procesSing occurs when the SVC is the EXIT SVC (SVC 3); status 
is not saved when this SVC is issued. Instead, IPL removes the 
top element from the stack and makes it current (restores the 
registers and loads the old PSW) so control passes back to the 
Point at which the SVC was issued. Because of the way the stack 
is used, the pointer 18S initially set to point 32 below the 
bottom of the stack. IPL checks for stack overflow and stack 

Ue oyats” either of which causes a disabled wait state 


An SVC stack entry has the following format: 
Hex Offset Length Description 


+ 00 8 PSW at time of interrupt 
+ 08 2 Interruption code 
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+ OA 2 Reserved 
+ 10 20 Registers 1-5 at the time of interrupt ) 


The nucleus map CNUCMAP) is not included in a dump unless NUCMAP 
is specified on a request for print dump service aid. 


For a list of the SVCs that are available at IPL-time, see 
"Initial Program Loader™ in Section l. 


There 1s a nucleus map lookup service, NUCLKUP, which can be 
used either to (1) retrieve the address and AMODE of a nucleus 
CSECT or entry point or (2) retrieve the name and address of the 
nucleus CSECT pointed to by a given address from the nucleus 
lookup routine, IEAVENLU. For more information on NUCLKUP, see 


SPL: system Macros and Facilities. 


IEAVNIPO DIAGNOSTIC TRAP ROUTINES 


Because system recovery routines are not available while 
IEAVNIPO processes, IEAVNIPO provides diagnostic support for 
software and hardware errors by trapping the errors. The 
IEAVNIPO trap routines stop the initialization process at the 
time the error occurs and provide diagnostic information in the 
form of wait state codes. 


ABEND Trap (NIPABEND) 
DESCRIPTION OF TRAP: IEAVNIPO saves the ABEND SVC entry from 
the SVCTABLE (€set up at SYSGEN time) in the NVT and replaces the 
entry with the address of NIPABEND. IEAVNIPO also changes the 
SVC type to l. 
OPERATION: Traps requests for ABEND and loads a wait state PSW 
to terminate NIP. ) 
OUTPUT: Wait state PSW contains wait state code X'30' in bits 
56-63 and a completion code, if any, in bits 36-47. 
EXIT TO: System wait state. 


Machine Check Trap (NVTMCPSW) 
DESCRIPTION OF TRAP: IEAVNIPO saves the machine check PSW and 
replaces it with a PSW that points to the next sequential 
instruction with machine checks enabled. 


OPERATION: Traps machine checks and loads a wait state PSW to 
terminate NIP. 


OUTPUT: Wait state PSW contains wait state code X'44' in bits 
56-63, and the logical address of the processor in bits 32-47. 


EXIT TO: System wait state. 


Recovery Termination Management Traps (NPORTPO1-15) 
DESCRIPTION OF TRAP: [TEAVNIPO replaces the addresses of the 
routines in the RIM1 table with the addresses of trap routines 
NPORTPO1 through NPORTPLS5. 
ENTRY FROM: Recovery termination management. 
OPERATION: Traps calls to recovery termination management that 
occur during IEAVNIPO and loads a wait state PSW to terminate 
ITEAVNIPO. 


OUTPUT: Wait state PSW contains an index that represents the J 
requested entry in the RTM1 table and wait state code X'64'. 


EXIT TO: System wait state. 
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Unexpected Program Check Trap (NPOUXPC) 


STAE/ESTAE (SVC 60) 


DESCRIPTION OF TRAP: IEAVNIPO saves the SYSGEN program check 
new PSW and replaces it with a PSW that points to a BR 10 
instruction; it sets register 10 to the address of NPOUXPC. 


OPERATION: Traps unexpected program checks and loads a wait 
state PSW to terminate IEAVNIPO. 


ae Wait state PSW contains wait state code X'G6' in bits 


EXIT TO: System wait state. 


Trap 

DESCRIPTION OF TRAP: IEAVNIPO saves the STAE/ESTAE SVCTABLE 
entry in the NVT and replaces it with the address of NOP code. 
IEAVNIPO also changes the SVC type to l. 


OPERATION: Traps requests for STAE or ESTAE and clears register 
15. 


OUTPUT: Register 15 contains zeroes. 


EXIT TO: Caller of STAE or ESTAE. 


TEAVNIPM DIAGNOSTIC TRAP ROUTINES 


Trap Routine 
ABEND 

Machine Check 
RTM 


STAE/ ESTAE 
ENQ/DEQ 
SVC Types 3 & 4 


Before system recovery routines are available, IEAVNIPM provides 
diagnostic support for software and hardware errors by trapping 
the errors. The trap routines detect errors that occur during 
NIP, stop the initialization process at the time the error 
occurs, and provide diagnostic information in the form of wait 
state codes and messages. 


The following table lists the trap routines, the action taken by 
NIP, and the module that provides the corresponding regular 
system service. 

Regular System Service 


Resolution Begins After 
Wait State X'40" or X'"30! IEAVNIPX 
Wait State X'044! IEAVNPO6 
Wait State X'064! IEAVNIPX 
BR14 (CNo-op) IEAVNPA6 
BR14 (CNo-op) IEAVNP23 
Wait State X'065' IEAVNPOS5 


Because RTM has not been initialized, NIP does not issue any 
ABENDs or MEMTERMs, nor does it request any type of dump (CSDUMP 
or ABDUMP). Therefore, a stand-alone dump is required to 
diagnose any problem for which the cause cannot be determined 
from the wait state code and the diagnostic data provided with 
i 


ABEND Trap (NIPABEND) 


DESCRIPTION OF TRAP: IJIEAVNIPM places the address of the 
NIPABEND routine in the SVC table entry for the ABEND SVC CSVC 
13). IEAVNIPM also changes the SVC type to 2 so that the 
contents supervisor RIM CIEAVNP05) will not alter the entry when 
it initializes type 3 and type 4 SVCs in the table. JIEAVNPO05 
initializes the SVC 13 entry point address in an entry in the 
NVT; at the end of NIP processing, IEAVNIPX resets the SVC table 
entry from the trap routine address to the SVC 13 entry point 
address. 


ENTRY FROM: SVC SLIH. 
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OPERATION: Traps ABEND requests and provides diagnostic 
information about the ABEND. 


INPUT: Register 1 contains the ABEND code. 


OUTPUT: Message IEA303W contains the ABEND code X'40'; the wait 
state PSW contains the ABEND code and the wait state code. 


EXIT TO: NIPSWAIT service routine. 


Type 3 and 6 SVC and LOCATE SVC Trap (NIPSVC) 


DESCRIPTION OF TRAP: IJEAVNIPM places the address of the NIPSVC 
routine in the SVC table entries for all type 3 and type @ SVCs. 
After the LPA is constructed, the contents supervisor RIM 
CTEAYNPO>) replaces the entries with addresses of the proper SVC 
routines. 


Although IJEAVNIPM does not treat LOCATE SVC 26 requests as 
errors, it does trap LOCATE requests. JIEAVNIPM places the 
address of NIPSVC in the SVC table entry for the LOCATE SVC CSVC 
26) and changes the SVC type to 2. After NIP processing is 
complete, IEAVNIPX resets the SVC 26 entry with the address of 
the LOCATE SVC routine. 


ENTRY FROM: SVC SLIH. 


OPERATION: Traps any type 3 and type 4 SVC request during NIP 
and prepares NIP for termination; traps LOCATE SVC requests and 
Passes control to the NIP LOCATE module, IJEAVNP12. 


INPUT: Register 5 points to the RB that contains the SVC code. 


OUTPUT: For type 3 and type @ SVC requests Cexcept LOCATE), 
field NPMFLWSC of the PSW structure CKPMWTPSW) in IEAVNIPM 
contains wait state code X'65' and field NPMIDPSW contains the 
SVC code. 


EXIT TO: For type 3 and type 4 SVC requests, return to NIPSWAIT 
service routine; for LOCATE SVC (SVC 26) requests, return to 
issuer of LOCATE. 


Recovery Termination Management Trap (NPRTMTAB) 


DESCRIPTION OF TRAP: IEAVNIPM replaces the address of the 
recovery termination management table (RTM1) -- located in field 
CVTBTERM of the CVT -- with the address of the table in 
NPRTMTAB. IEAVNIPX resets the trap prior to the end of NIP. 


OPERATION: NPRIMTAB consists of a table of addresses that point 
to code that diagnoses each entry to recovery termination 
management for software recovery. NPRIMTAB traps all entries to 
recovery termination management. 

INPUT: Register 1 contains the entry code identifier. 

OUTPUT: Field NPMIDPSW of the PSW structure (NPMWTPSW) in 
IEAVNIPM contains a number identifying the RIM1 entry called; 
field NPMFLWSC contains wait state code X'64'. 


EXIT TO: NIPSWAIT service routine. 
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ESCRIPTION OF WAIT STATE CODE X‘'64' 
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A wait state code of X'64" indicates that an attempt was made to 
enter RTM during NIP. A reason code is also supplied with this 
wait state code (PSW bits 44 to 51). The most common codes 
encountered are 5 (SVC error) and 9 (program check). 


Wait state code X'64%' with a reason code of 5 occurs when an SVC 
instruction 1S issued in an invalid mode (such as SRB or locked 
mode). However, the cause is usually not locked mode, because 
it is common for system routines to issue an ABEND CSVC 13) 
while holding a lock. Therefore, the first thing to do with a 
wait state code of X'64", with a reason code of 5, is to 
determine if an SVC 13 was the last SVC issued Clook at SVC OLD 
PSW or trace table). 


If SVC 13 was the last SVC, the Rl field in the trace table 
contains the ABEND code and the R15 field contains the reason 
code. The ABEND code might give some clue as to which SVC 
issued the ABEND. If so, examination of the trace table can 
show what module issued the SVC that caused the ABEND. It may 
be that the input to that SVC was the cause of the error. 


If a wait state code of X'64" with a reason code of 5 occurs and 
SVC 13 was not the last SVC issued, then the error is a true SVC 
error. It could be that a module is erroneously issuing an SVC 
while holding a lock. However, it is also possible that some 
routine that was previously in control returned to its caller 
without releasing a lock. In this case, the SVC-issuer is 
correct. 


A wait state code of X'64' with a reason code of 9 indicates 
that a program check Cother than a resolvable translation 
exception) has occurred. The program check OLD PSW indicates 
the type of exception and where it occurred. The registers at 
the time of the exception are saved, with X'48'" placed in the 
LCCA. If the error was a translation exception Cprogram 
interrupt code of X'10" or X'11"'), location X'90" contains the 
address that could not be translated. The trace table also 
contains this information. 
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SECTION 6. PROGRAM ORGANIZATION 





This section describes the physical organization of the object 
modules that perform system initialization functions. 

Figure 4-1 through Figure 4-15 show the control flow among the 
object modules during system initialization. 
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Figure 4-1 (Part 1 of 13). System Initialization Module Flow 
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Figure 4-1 (Part 2 of 13). System Initialization Module Flow 
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@ Initialize RTCT. 
Acquire quick ceil pool. 
@ Initialize recording 
buf fer. 


| 




















IE AVNPO6 - MCH IGFPEXIT - MCH 








@ [nitialize control 


< yp © Initialize MCH for 
registers 14 and 15. 


IPL processor. 


















IEAVNP27 - 
Reconfiguration 


Obtain and initialize 
the ICHPT and CMT. 


JEAVNPA2 - IOS 


@ Test availability of 
non-direct access 
devices. 





IOSVNPTH - IOS 


@® Determine 
logical paths. 












[EAVNPC1 - NIP 







Initialize a valid 
console for NIP. 










IE AVNPB2 - IOS JOSVNPTH - [OS 
@® Determine 


Test availability of logical paths. 


q¢________> direct access 
devices. 



















TEAVNP11 - VSAM 


Open the system 
catalog. 










JEAVNP76 ~ NIP 





Locate and open 
SYS1.LOGREC. 
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IEAVNIPM - continued 


® Initialize NVT. 


® Provide services 
common to RIMs: 


- Place system in 


disabled wait states. 


~ Determine time. 


- Set up diagnostic 
support for errors. 


- Load IEAVNP12 
for LOCATE. 


@ Load and delete 
RIMs. 





JEAVNPOS - NIP 










® Open SYS1.PARMLIB. 
© Merge and analyze 

system parameters. 
® Open LNKLST. 





IEAVNPE8 - RSM 






© Process the REAL 
parameter. 


IEAVNP23 - 
Global resource serializotion 


® Initialize global 
resource serialization 
control blocks. 


See Figure 4-4. 21 


IEAVNPOQ4 - ASM 
(ILRASRIM) 








Open, PLPA, common, 

and duplex page dato 

sets. 

Retrieve quick stort 

informotion. 

® Restore PLPA to 
previous IPL status. 

® Initialize ASM 

environment. 


295 





IEAVNPAB8 - VSM 


@ Expond the SQA 
and ESQA. 












Figure 4-1 (Part 4 of 13). System initialization Moduie Fiow 
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[EAVNPC8 - VSM | 
® Initialize PGTs, 
® Turn allocation 


Se 


IEAVNPAS 


® Build and initialize 
the APF table. 

















ILROPSOGO ~- ASM 





® Open a page 
dota set. 


ILRASRM2 - ASM | 


® ASM initialization 
service routines. 











ILRIMMSG - ASM 


® Issue output 
messages. 


ILRPREAD 


© 1/0 to read or 
write slots ona 
poge dato set. <« 

® |/0 to test or 
reset a coched 
ouxiliory storoge 
subsystem. 

® |/0 to obtain 
the address of 
the cache 
array element. 





XPTs, and 
entries for PLPAs. 


IGVEAAQA - VSM 


bit on. 











IARVB - RSM 





wv Build poge tables. 
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IEAVNIPM - continued 


IEAVNP 14 - ASM 
(ILRASRM1) 
® Open local page 
dato sets. 






® Initialize NVT. 


® Provide services 
common to RIMs: 


- Place system in 
disabled wait states. 


® Open swap data 
sets. 










- Determine time. 


- Set up diagnostic 
support for errors. 


- Load IEAVNP 12 
for LOCATE. 


® Lood ond delete 
RIMs. 









® Complete 
initialization of 
ASM environment. 


ee 


Figure 4-1 (Part 5 of 13). System Initialization Module Flow 
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[LROPSOO - ASM 





® Open a page or swap 
data set. 









ILRIMMSG - ASM 


® Issue output messages. 





ILRPREAD 





® 1/0 to read or write 
slots on o swap or poge 
dota set. 

® |/0 to test or reset o 
cached ouxiliary storage 
system. 

® 1/0 to obtain the 

oddress of the cache 

orray element. 
















[LRASRM2 - ASM 









service routines. 
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[EAVNP25 






IEAVNPCS 


@ Process IEASVCxx. Contents Supervision 


@ Instol!l nucleus-resident 
modules. 
See Fiqure 4-7. 


IEAVNPOS 
Contents Supervisor 


® Build LPA. 

























IEAVNIPM - continued 


® Initialize NVT. 


@ Build the PLPA. 

























® Provide services 


common to RIMs: IEAVNPS5 


Supervisor Control 






- Place system in 














| disabled wait states. ® Build and ® jnitialize system 
initialize CDE and ESR SVC tables. 
- Determine time. cell pool control 
area. 






Set up diagnostic 
support for errors. 


ILRQSRIT - ASM 


® Sove LPA slot 
information. 
@® Write QSRCD, 
EQSRD, XQSRO 
and TPARTBLE 
to PLPA page 
data set. 





IEAVNPB8 - VSM 


@ Initialize CSA 
and EQSA. 


Load IEAVNP 12 
for LOCATE. 










@ Load and delete 
RIMS. 















IEAVNP47 - 
Event notificatian 






ILRPREAD - ASM 





@ Initialize the 
event notification . 
contro! block I/O to read or 
structure. 















write slots on 
the PLPA page 
data set. 


IARVB - RSM 


®@ Build page tables. 


















[EAVNPD6 - RTM 


® Initialize task 
recovery. 












IEAVNPO9 
Supervisor Contral 







@ Initialize the ASVT. 
@ Build and initialize 
AF TS and ASTS. 


[EAVNPD8 - RSM 


@ Initialize RSM 
control blocks. 
@ Process RSU, REAL 
and VRREGN 
parameters. 
@ Protect pages af 
system areas. 
















IARMS - RSM 


@ Process REAL 
and VRREGN 
parameters. 














IARMT - RSM 













@ Pracess RSU 
parameters. 







Figure 4-] (Part 6 of 13). System Initialization Module Flow 
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[EAVNIPM - continued IRARMCPU - SRM 


eyes @® Seorch processor 
* Initiolize NVT. adjustment toble. 


® Provide services 
common to RIMs: 
IRARMICS - SRM 





~ Place system in ® Process installation 
disobled wait states. control specification 
list. 
- Determine time. IEAVNP10 - SRM 
- Set up diognostic IRARMANL - SRM 


support for errors. neo . 
@ Initialize SRM using 


- Load [IEAVNP 12 APG, IPS, ICS and @ Analyze syntax. 
for LOCATE. OPT parameters. 

® Load and delete IRARMIPS - SRM 
RIMs. 





® Process IPS list. 
















IRARMOPT - SRM 





Process OPT list. 


[EAVNP1F - SRM IGVNIPCR - VSM 


Obtain contiquous 
virtual storage. 


@® Initialize SRM 
channel measurement 
functions. 





393 





IARXT - RSM 


Obtain contiquous 
real storage. 









JEAVTABI - RTM 






[EAVNPD1 - ABDUMP 





Initializes ABDUMP. 











® Initialize ABDUMP. 





IEAVNPD2 - SVCDUMP IEAVTSDD - RTM 
@ Initialize SVCDUMP. ® Process DUMP 
system parameters. 















IEAVNPX1 - NIP EAVTSDI ~ RTM 


@ Perform initial 


cleanup. Initiolize SVCDUMP. 








OU 


Figure 4-1 (Part 7 of 13). System Initialization Module Flow 
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IEAVNIPM —- continued 


@® Initialize NVT. 
IEAVNPF5 ~ PC/AUTH 


® Provide services 
common to RIMs: @® Initialize PC/AUTH 
address space. 


- Place system in 


disabled wait state. . 
See Figure 4-2. 





~ Determine time. 


- Set up diagnostic 


support for errors. IEAVNP51 ~ Trace 


- Load IEAVNP12 ® Create TRACE 
for LOCATE. address space. 
® Initialize system 
® Load and delete trace function. 


RIMs. 





See Figure 4-3. 


[EAVNP33 - GRS 
(ISGNTASC) 


© Initialize global 
resource Serialization 
address space. 


See Figure 4-4. 


IEAVNPS7 


Dumping Services 

®@ Initialize dumping 
services address 
space. 


See Figure 4-5. 











IEAVNPA1 - 

Communications Task IEAVN600 

@ Process MCS console 
definitions in 
CONSOLxx member of 
SYS1.PARMLIB. 










LINK 





Process CON system 
parameter. 









See Figure 4-6. 








v 
& 


Figure 4-1 (Part 8 of 13). System Initialization Module Flow 
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JEAVNP16 - 
Data Management 









[IEAVNIPM - continued ® Build table of EXCP 
appendages for 
® [Initialize NVT. unauthorized 


programs. 





® Provide services 
common to RIMs: 
IEAVNP13 - 


- Place system in Master Scheduler 


disabled wait state. 
@ Save SMF parameters. 
- Determine time. 
@® Save SSN suffixes. 
~ Set up diagnostic 
support for errors. ® Queue commands from 
SYS1.PARMLIB. 
- Load IEAVNP 1 2 
for LOCATE. ® Save LOGCLS and 
LOGLMT values. 
® Load and delete 


RIMs. ® Save MSTJCL suffix. 








IEAVNP 17 - GTF 






® Initialize GTF's 
interface with 
monitor call 

pracessing. 







JEAVNP18 - 
Master Scheduler 








@ Initialize the input 
parameters to IEEZ8819. 
@ Load the statement 
pracessar routines. 
@ Laad the general parmlib 
scan routine. 
@ Process SCHEDxx member 
af SYS1.PARMLIB. 
@® Test availability 
| See Figure 4-7. of MSSC devices. 
System Communicator 
IEAVNPC2 - IOS 
@ Prepare oe @ Tests shorability 
MeuOr ng o and availability 
virtual volumes. Ar devices 








Figure 4-1 (Part 9 of 13). System Initialization Module Flow 
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LEAVNP20 
Master Scheduler 


@ Process the CLOCKx x 
member of 
SYS1.PARMLIB. 

















IEAVNIPM - continued 





® Initialize NVT. See Fi 4-7 
ee Figure 4-7. 


® Provide services 
common to RIMs: 


- Place system in 
disable wart states. 


IEFVNPF2 - [0S 


@ Initialize [OS 
options. 


IEAVNP 15 (IEAVAPOO) 
Volume Attribute 


® Initialize UCBs 
with volume 
attributes. 


~ Determine time. 


- Set up diagnostic 
support for errors. 


- Load IEAVNP 12 
for LOCATE. 


® Load and delete 
RIMs. 





JEAVNP1B - VSAM 


@ Close system 
catalog. 


[EAVNPOO 
Reconfiguration 








@ Initiolize the IPL 
processor’s TOD 
clock ond console 
RESTART text. 

e@ Initiolize the 

non-IPL processor . 











@ Remove NIP from 


system. 





Figure 4-1 (Part 10 of 13). System Initialization Module Flow 
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IEAVNPOO 
Processor [nitialization 





Initiolize 
TOD clock 
for IPL 

processor. 








@ Bring the non-IPL 
processor online. 
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LINK 
IEEVIPL [EEMB809« - MS] 
® Master scheduler @ Initialize master 
base initialization. trace table. 


JEAVN 700 














LINK ® Create 
cammunication 
task address space. 
See Figure 4-8. 
JEFJSINT - MSI 
BALR 
® Initialize 
subsystem 
interface. 30 
IEF JSBLD 
A 
IEFOBINT CALL ® Initialize 
LINK subsystems. 
® Initialize the 
SWA manager. Ea 








IEFA8410 


@® Initialize allocatian 
address space. 













LINK IEFE8400« 






@® Verifies entries 
in the EDT 








See Figure 4-9. 








*These modules ore described 
in detail in System Logic Library. 


Figure 4-1 (Part 11 of 13). System Initialization Module Flow 
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® Initiator 


See Figure 4-11. 


@ Wait for the 


communication task 
command initialization 
to complete. 


Moster scheduler 
region initialization. 


Woit for SMF 
initialization to 
complete. 


Process automatic 
commands. 





Figure 4-1 (Part 12 of 13). 


AT TACH 


CALL 


LINK 


ATTACH 


ATTACH 


ATTACH 


ATTACH 


LINK 


LINK 


LINK 


IEAVC 701 


@ Communication 
task command 
initialization 
routine. 


IEFSJINT 
@ SJF JDVT 
initialization. 


[EFENFWT# 


@ Wait for event 
notification. 






IEEMB820 





@ Create SMF 
address space. 





84 


IOSRMIHT«* - IOS 
@ Handle missing 
interrupts. 

IOSROUTG - IOS 


® Record IPL/outage. 


IEAVTMSI 








@ Initialize Recovery 
Termination 
Manager. | gs | 
JECVIOSI* 
®@ Initialize IOS 


dynamic pathing. 
® Establish IOS 






storage manager 
as an ENF 
listener. 


ICBINIT 


®@ Initialize MSS. 





System Initialization Module Flow 
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IKJEFXSR 


® Initialize TSO 1/0 
service routines. 


[EEMB88 1 


@ System address 


LINK 


space create 
routine. 





IEAVTRET#* 


® Initialize 


asynchronous 





recording. 


[EAVTSDT# 


ATTACH 
®@ Initialize SVC dump 


for master scheduler. 





[EAVTMTC* 


® Terminate 


address space. 





«These modules are described 
in detail in System Logic Library. 
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JEEMB860 - continued ILRTMRLG* - ASM 
® Colls ILRTMIOO. 
® Puts address of ILRTMIOO - ASM 
® Moster scheduler group operator ® Open 
region initialization. ATTACH module into ASMVT LOAD BALR DELETE SYS1 . STGINDEX 
control blocks. with VSAM OPEN 
See Figure 4-10. ® Waits to do ony ® Coll ILRPREAD 
"release lagical to reod/write 
@ Woit for SMF group’ requests . the TPARTBLE. 
initialization to ® Restore VIO doto 
complete. ICHSECOO sets if worm stort. a6 


See Figure 4-11. ATTACH ® Initialize security. 






ILRPREAD* - ASM 





@ Process automatic 


commonds. IEFJSIN2 Read or write slots 


on the PLPA page 
dota set. 







@ Initialize 
CALL subsystem. 


See Figure 4-14. 87 









IEFHB412 


[EFHB410* 










@ Disploy ollocation 
scavenge routine. 





® Monoge disploy 
allocation 
tables. 












75 








IEEVWAIT 


Master scheduler wait 







IEEMB805 






® Start primary job 


@® Initialize system 
entry subsystem. 


log. 








® Wait to process 
system commonds. *These modules are described 


in detail in System Logic Library. 





Figure 4-1 (Part 13 of 13). System Initialization Module Flow 
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IEAVNIPM 






IEEMB88 1 






IEAVNPFS 







System 
PC/AUTH address space 
RIM create 


routine 


IEAVEMCR* *These modules are described in 


detail in System Logic Library. 
Address 
space 

creation 


The region control task is the first 
a ome ee eee =| task dispatched in the newly-created 
address space. 


IEAVARQO + 










Region 
control 
task 


IEAVXECR 


Entry table 
creation routine 









IEEPRWI2 










Started 
task 
control 


IEAVXMAS 


PC/AUTH 
address space 
initialization 


IEEMB8835* 


System address 
space initialization 
WAIT /POST 

routine 


IEESB605 









IEAVXECO* 


Entry table 
connect service 
routine 





Figure 4-2. Initializing the Program Call/Authorization Address Space 
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IEAVNIPM 








IEEMB881 


System 
address 
space create 
routine 











| IELAVEMCR* 
(| 


Address 
space 
creation 











ILAVAROO* 


Region 
control 
task 








ATTACH 


IEEPRWI2 


Started 
control 
task 





IEESB605 LINK 





*These modules are described in 
detail in System Logic Library. 


Figure 4-3. 
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IEAVETAI» 


TRACE 
Address space 
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IEAVETSI * 





IEAVETAT 
System trace system trace 
resource ALTRTRC 
initializatian service 
madule interface 
(RIM) 

IEAVETAC « 
LINK 


System trace 
address space 
create routine 





The region contral task is the first 
task dispatched in the newly-created 
address space. 


IEAVXECR 


Entry table 
creation 
routine 


IEAVXECO 


Entry table 
connect service 
routine 







and function 
initialization 


IEEMB883 





System address 
space 
initialization 
WAIT/POST 
routine 





Initializing the System Trace Address Space 
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IEAVNIPM IEAVNP23 IEAVNP23 


BALR 








Globol resource 
serializatian CTC 
canfiguration 
PARMLIB pracessor 


LINK Globo! resource 
seriolization 
control black 
initializatian 

































































2) 
OQ IEAVNP23 IEEMB8B7 
@ (/SGNPARS) 
e Glabal resource LINK Generalized parser 
serialization parse 
setup madule 
! IEAVNP 33 
(ISGNTASC) 
IEAVNP 23 
IEAVNP 23 
Global resource (ISGNRNLP) (ISGNRNLV) 
LINK serializatian 
address space Globol resource BALR Glabal resource 
creotian serializatian serializatian 
10 resource name resource name fist 
list PARMLIB verificatian 
pracessor 
IEEMB88 1 
System 
address space 
create 
routine 
ATTACH 
JIEAVEMCRe 
Address 
space 
| creation 
The region control task is the first 
Tota ~-- | task dispatched tn the newly-created 
address space. 
IEAVAROO+ 7 
Region 
contral 
task 
IEEPRWI2 
Started 
task 
contral 74, 
LINK 
IEESBE05 c | These modules are described in 
detail in System Logic Library. 
————— we 
(Part 2 af 2) 





Figure 4-4 (Part I of 3). Initializing the Global Resource Serialization Address Space 
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From 
JEEVIPL 


IEFENFFX 


Event 
notification 
request 

router 


[EFENFNM«# 


Event 
notification 
mainline 

processing 














ISGNPGIM 








Global resource 
serialization 
initialization 
post 











ee ee 


Figure 4-4 (Part 2 of 3). 


LINK from 
IEEPRWI2 


ISGNASIM 


Global resource 
serialization 
address space 
initialization 


BALR 
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ISGSALC 


Global resource 


serialization 
storage manager 





ISGSGLH 


Global resource 
serialization 
global /local 
hasher 






ISGGSRVI 


Global resource 
serialization 
mainline service 
routine 


initialization 
Sh 
ISGNWMSI 


Global resource 
serialization 
wait for master 
scheduler 
initialization 








JEEMB8BS 


system address 


space initialization 
WAIT /POST 
routine 
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ISGCMDR« 


Global resource 
serialization 


command 
router 





ISGBTC 


Global resource 
serialization 
CTC ring 
processor 
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Globo! resource 
serializotion 
address space 
initializotion 


[SGCQMRG 


Global resource 
serialization 
queue 

merge 


ISGCQMRR: 
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Figure 4-4 (Part 3 of 3). 


ISGGRPOO 


Global resource 


serialization Wi-------- 


resource 








processor 


ISGNGRSP 


Global resource 
serialization 
option processing 


ISGNERRX: 
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ISGBCI* 


Globol resource 
serialization 


ring processing 
command interface 





ISGQSCAN » 


Global resource 
serialization 
queue scanning 
service 


ISGGQSRV* 


Global resource 
serialization 
queue services 














]ISGGQWBO* 


Global resource 
serialization 
QWB service 
routine 


ISGGQWB2: 
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POST 









ISGBCI» 


Globol resource 
serialtzotion 

ring processing 
commond interfoce 


ISGMSGOO 


Globol resource 
seriolizotion 
message 
pracessor 












ISGCRCVs 


Global resource 
serialization 


command 


recovery 
module 





Initializing the Global Resource Serialization Address Space 
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IEAVNIPM 


| 


0 


IEAVEMCR* 


Address 


space 
creation 





[IEAVAROO« 


Region 


contral 
task 





ATTACH 


IEEPRWI2 






Started 
tosk 
control 






IEES8605 





Figure 4-5. 


LINK 


4-20 MVS/XA System Init Logic 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


IEAVNPS7 


IEAVTSAS 








Dumping 
services 
RIM 


Dumping services 
address space 
creation 












LINK 


IEEMB88 1 


System 
oddress 
spoce creation 


ATTACH 


The region control tosk is the first 
task dispatched in the newly-created 
address space 


«These modules are described in 
detail in System Logic Library. 


[EAVTSAI 


Dumping 
services 


address 
space 
initialization 





Initializing the Dumping Services Address Space 
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From IEAVNPAT 


IEAVN600 




























IEEMB878 [EEMB887 
@ Process the @ Read the 
CONSOLxx statements. 
member. @ Parse the 
stotements. 
[EAVN601 
[IEAVN602 
[EAVN604 
@ Set up Console 
t—H—__ > <> Data Area for 
eoch specified 
statement. 
[EAVN610 
IEAVN611 
IEAVN612 





@ Validate the 
statements and 
the data. 


LEAVN6135 


@ Select the 
master console. 








@ Volidate the 
olternate 
consoles. 











IE AVN614 


@ Initialize the UCM 
control blocks. 





Figure 4-6. Processing the CONSOLxx member of SYS1.PARMLIB 
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From IEAVNIPM 


IEAVNP18 

Scheduler Interface to 
the General Parmlib 
Scan Routine 





@ Initializes the 
input parameter 
list (IEE Z8819) 
to IEEMB888. 


Loads the 
statement 
processor 
routines. 





@ Loads IEEMB888. 





From IEAVNIPM 


TEAVNP25 


@ Process IEASVCxx 
member of 
SYS1.PARML1B. 












From IEAVNIPM 


JEAVNP20 


@ Process CLOCKx x 


member of 


SYS1.PARML 1B. 

















IEAVESTU 


@ Update the SVC 
table entry for 
type 1, 2, and 6 
nucleus resident 
SVCs. 
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IEF PPT 
IEEMB888 
General Parmlib PPT Statement 
Processor 






Scan Routine 













® Updates the 
Program Properties 
Table with entries 
for programs with 
special 
attributes. 


@ Scans specified 
SYS1.PARMLIB 
members for 
valid statement 

types. 
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IEEMB889 
MT Statement 
Processor 





@ Invokes the 
proper statement 
type processor 
routine to 
process the 
statement types. 














@ Defines the size 
of the Master 
Trace Table. 



















IEFAB41F 
EDT Statement 
Processor 












@ Defines which 
Eligible Device 
Table the system 
is to use. 





@ Loads the EDT. 










IEFRCSTP 
RESTART/NORESTART 
Service Processor 








Updates the table 
of codes eligible 
for automatic 
restart (IEF YRCDS). 









IEAVNS25 
SVCPARM Statement 
Processor Routine 










TEAVNP20 


@ Processes the 
OPERATOR 
statement. 






Processes the 
TIME ZONE 
statement. 











ro | 


Figure 4-7. Processing the SCHEDxx, IEASVCxx, and CLOCKxx members of SYS1.PARMLIB 
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ww Link from IEEVIPL 


IEAVN 700 IEEMB88 1 * 


Communication System Address 
task address space create 
space create routine 


















Cross Memory Post 


*xThese modules are described 
in detail in System Logic Library. 


Figure 4-8. 







mm a a ee 


IEEPRWI12« 


Started task 
control 
processing 









IEAVN70 1 


Communications 
task address 
space 
initialization 


ATTACH 
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Initializing the Communications Task Address Space 
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The region control task is the first 
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pe «These modules ore described in 
detail in System Logic Library. 


Figure 4-9. Initializing the Allocation Address Space 
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Library . 
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Figure 4-10. Initiation of the Master Scheduler 
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*These modules are described in 
detail in System Logic Library. 


Figure 4-11. Initializing the System Management Facilities Address Space 
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Figure 4-12. Initiation of the Job Entry Subsystem 
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«These modules are described in 
detail in System Logic Library. 


Section 4. Program Organization 4-27 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


From region 
control task 





via ATTACH 







IEEMB88 1 


System oddress 
space initiolizotion 
routine 


For system 
address 
spaces 






















IEEPRWI2 = 







STC GETPART routine 


For LOGON 
commands 
vio XCTL 


IKJEFLA* 


LOGON processor 












For MOUNT commonds 
vio XCTL 


For START commands 
via XCTL 


IEEVSTAR» JIEEVMNT 1 # 
START commond | MOUNT commond 


syntax check routine syntax check routine 















































vio branch via bronch vio XCTL 
IEEVICL« IEEVJCL is looded with 
IEEVSTAR ond IEEVMNT1. 
Job control longuage 
build 
|) 
io XCTL 

«These modules ore described in ue via iEEJSWT 
detail in System Logic Library. BALR e 

STC write JCL routine 
IEESB605 passes control to the | ss ieespcors 
initiotor via LINK: the initiator IEESB605« via IEESB601» 
oe routine (IEFSD265) attaches Job scheduling BALR SWA and TIOT initiolizotion 
ee the artes peynimie at subroutine for privote cotalogs 

re) 
processing. IEEVMNT2 returns control 
to JEFSD263 via o bronch. 
‘ via [EEVSMSG* 
vio XCTL BALR 
STC message module 






IEEVMNT2 
MOUNT command 
processor 


In any case, when the command tosk 
hos completed processing, the initiator/ 
terminator oversees termination of the Exit to region Note: 

problem progrom and returns control control task The areos enclosed by broken 
to IEESBEOS . lines seporote lood modules. 


IEEPRTIN2* 


STC FREE REGION 
routine 








Figure 4-13. Started Task Control (STC) Module Flow 
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#* When creating the JESSAUX address space, the caller's address space «These modules are described in detail 
is the JES3 address space. When creating the PC/AUTH, ALLOCAS, in System Logic Library. 


GRS, or DUMPSRV address space, the caller’s address space is the 
master scheduler's address space (ASID=1). 


Figure 4-15 (Part 1 of 2). Initializing a System Component Address Space Using IEEMB881 





4-30 MVS/XA System Init Logic LY28-1200-4 © Copyright IBM Corp. 1982, 1987 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


IEEPRWI2 


Started 






Region ATTACH 





Component's 

















control task control initialization 
task routine 
LINK 
Call Do companent- 
(From part 1 of 2) component's specific 
initialization initialization. 
routine. 
Post ECB 
EAERIMWT 
to allow 
caller of 
IEEMB881 to 
continue. 
If a limited 
function 
address IEEMB883 JEEVWAIT* 
space: BALR |System address WAIT 
® Wait far space WAIT/ post Master 
i r 
master POST routine POST wait ule 
scheduler 
initialization 
ta complete. 
® Ga inta a 
never-ending 
wait. WAIT 
If a full 
function 
address 
For a full space: 
function BR 
address ® Set return 
space: code. IEEMB883 
® Return to System 
[EEPRWI2. address space Master 
. WAIT/POST scheduler 
woe routine wait 
«These madules are described tn scheduler 
more detail in System Logic initralization BALR 
riPrary. to complete —_—__—_ IEEVSTAR* 
XCTL 


Camplete STC 
processing. 





Figure 4-15 (Part 2 of 2). 
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This section uses diagrams and text to describe the functions 
performed during system initialization. There are two types of 
diagram formats: HIPO and prologue. The diagrams are presented, 
as closely as possible, in their order of invocation and 
emphasize functions performed rather than the program logic and 
organization. Program logic and organization is described in 
"Section G: Program Organization." 


HIPO diagrams are arranged in an input-processing-output format. 
The left side of the diagram contains data that serves as input 
to the processing steps in the center of the diagram, and the 
right side contains the data that 1s output from the processing 
steps. Each processing step is numbered; the number corresponds 
to an amplified explanation of the step in the "Extended 
Description" box. The object module name and labels in the 
extended description point to the code that performs the 
function. 


The following figure shows the symbols used in HIPO diagrams. 
The relative size and the order of fields in control block 
illustrations do not always represent the actual size and format 
of the control block. 


Figure 5-1. Key to HIPO Diagrams 


Key to Symbols Used In Maethod-of—Operation Diagrams 


Primary processing - indicates major funtionai flow. 








within a diagram. 


Data movement, modification, or use. 


— 
| 
> Secondary processing - indicates functional flow 


<a Data reference -- indicates the testing or reading 
of a data area to determine the 
course of subsequent processing. 


Pointer -- indicates that a data area contains the 
address of another data area. 


g Connector - indicates that a diagram is 


continued on the next page. 








LY28-1200-4 (c) Copyright IBM Corp. 1982, 1987 Section 5. Method of Operation 5-1 


"Restricted Materials of IBM" 
Licensed Materials ~ Property of IBI4 


The prologue format diagrams contain detailed information that 
1s broken down anto four different headings. The four headings 
and the topics they document are: 


Module Description, which includes: 


° Descriptive name 

0 Function (of the entire module) 

e Entry point names, which includes: 
- Purpose Cof the entry point) 
- Linkage 
- Callers 
- Input 
- Output 


Exit normal 
— Exit error, if any 
f External references, which includes: 
- Routines 
- Dat=z areas, if any 
- Control blocks 
e Tables 
0 Serialization 


Module Operation, which includes: 


e Operation, which explains how the module performs its 
function. 
e Recovery operation, which explains how the module 


performs any recovery. 


Diagnostic aids, which provide information useful for 
debugging program problems; this includes: 


e Entry poirt names 

e Messages 

e Abend codes 

e Wait state codes 

0 Return codes for each entry point. Within each entry 
point, return codes might be further categorized by 
exit-normal and exit-error. 

0 Entry register contents for each entry point 

e Exit register contents for each entry point 


Logic Diagram, which illustrates the processing of the 
module, the input it uses, the output it produces, and the 
flow of control. The following figure illustrates the 
graphic symbols and format used in the prologue format 
diagrams. 
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LOGICKEY =~ Key to the Logic Diagrams STEP 01 


Callers 


This paragraph describes what this module 
N does. The same text appears under the 
>| | FUNCTION heading on the Module Description 


/ page. 
LOGICKEY 





Numbered steps describe the 
processing at a high level. 


A. Lettered steps describe the processing 
at a lower level. 


Input and output fields. 


The control block acronym or data area name 
appears above the in:ut and output boxes, 
and the field names appear within the 
boxes. A dotted arrow means the data is 


referenced, a solid arrow means the data is 
modified. 


External call graphic 
passing the parameter, TROB. 


suey 
\r— ITRFBR 


Internal call graphic (at 
the step indicated) passing 
two parameters. 


suv 
\re— SUBROUTN: 12 
EFMSG1, TFWAPMSG 










Macro instruction graphic 
with these keywords,. 
parameters, and options. 





(EAERIMWT, RCO) ASC3( TOBAASCB->ASCB ) 
ERRET(CVTBRET ) 


[06 Internal branch to the label 
and step indicated. 


\ 
?3RLABEL: 08 
/ 


Figure 5-2 (Part 1 of 2). Key to Logic Diagrams 
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LOGICKEY - Key to the Logic Diagrams STEP 07 


\ 
038 > 08, Step 06 branches here. A 
/ program call (PC) graphic 
BRLABEL shows an exit. 


Callers 


\ 
> Secondary entry point. 
PARAMETERS / 


SECONDEP| This paragraph describes the function of 
TROB THISLINE \| this entry point. Four parameters (to the 
MAXLINES erepopts| L——_+/ left) are passed an input. 


DOILABEL This is the beginning of an 
iterative DO group. 





A. Iterate graphic of the DO 10 
instruction to the specified step 
rumber . 


. Leave graphic of the DO instruction 
to the specified step number. 11 


[13] External return graphic, to 
the calling routine. | | 


\ 

12 > 42 This is an internal 
/ subroutine. 

SUBROUTN 


This paragraph describes the function 
of this subroutine. 







[13] Internal return graphic, to 
a step within this module. 


Figure 5-2 (Part 2 of 2). Key to Logic Diagrams 
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The diagrams in Section 5 are grouped according to three phases 
of initialization: IPL, NIP, and master scheduler 
initialization. Diagrams 1-8 provide details about the IPL 
phase of system initialization. Diagrams 9-70 provide details 
about the NIP phase of system initialization including details 
about the system component address space initialization that 
occurs during NIP processing. Diagrams 71-88 provide details 
about the master scheduler initialization phase. 
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Diagram 1. Initial Program Loader (IEAIPL00) Part 1 of 18 
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Diagram 1. Initial Program Loader (IEA]PLOO) Part 2 of 18 
Module Label 


The first phase of system initialization is the initial program 
loader (IPL), which begins execution when the operator 
initiates the LOAD process. Module |EAIPLOO prepares 
the virtual environment in which the IPL resource initiali- 
zation modules (IRIMs) will execute. It loads and calls each 
IRIM and provides common services for the IRIMs through 
IPL SVCs. The IPL SVCs are described in detail later in 
this extended description under ‘‘Processing IPL SVC 
Requests’. 


1  JEAIPLOO tests each frame of real storage from location |EAIPLOO 
4K up until it obtains fifty (50) available frames. 

|\EAIPLOO issues a Test Block (TB) instruction to test each 

frame. The TB instruction returns a condition code that 

identifies the state of the frame, and IEAIPLOQO sets fields 

accordingly. The following table shows the condition code 

and the state of the frame that the code represents: 


Condition Code State of the Frame 
0 good 
1 defective 
3 offline 


Note: The TB instruction does not actually set 
condition code 3. IEAIPLOO simulates this condition 
code when an addressing exception occurs ona TB 
instruction. 


When IEAIPLOO finds an available frame, it clears the frame’s 
storage key to zero and chains the frame to an available frame 
queue, 


2 ‘EAIPLOO uses the page backing service, ISVCPGFX 

(IPL SVC 4), to back a page for the IPL workspace 
and a page for IRIM. Two megabytes of virtual storage are 
allocated as IPL work space. This work space will contain 
the IPL vector table, tablesthat IEAIPLO2 will build, and 
the IRIMs as they execute. The default load frame para- 
meters will be saved in IVTPARMD. 


Extended Description Module Label 


Wa] go Ayrodosg — syetsayeya] pesuasr’y 


“INT $9 STEMI TAL pI}9143S9 4, 


sId0T wWuy waysks VYX/SAW Q-C 


L861 ‘7861 “I0D Wa 142uUAdoD @ -00ZI-8ZAT 


Diagram 1. Initial Program Loader (IEAIPLOO) Part 3 of 18 
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Diagram 1. Initial Program Loader (IEAIPLOO) Part 4 of 18 


Extended Description Module Label 


3 IEAIPLOO issues ISVCXDAP (iPL SVC 0) to access the 
IPL volume on SYSRES and reads the following: 


@ The volume label of the IPL device to determine the 
serial number and VTOC address 


@ The format 4 DSCBE of the VTOC to determine the 
number of cylinders on the volume and the number 
of tracks per cylinder 


@ The format 1 OSCB for the SYS1 .NUCLEUS data 
set to determine the start and end addresses of the 
extent of this data set 


[EAIPLOO copies this data into the IVT, which is the 
communication area for the IRIMs, IEAIPLOO, and 
IEAVNIPO. 


4  JEAIPLOO issues the module loading service, IPL SVC 6, 
to load module IEAIPLO1 into the IVTIRIML field in 
the IVT. IEAIPLO1 contains a suffix list, a list of two- 
character |RIM identifiers that IEAIPLOO will append to the 
root “IEAIPL” to form IRIM names. This list represents the 
IRIMs that [EAIPLOO will call during the first phase of system 
initialization. The entry point of IEAIPLO1 identifies the 
start of the list; two bytes of binary zeroes identify the end 
of the list. Thus the suffix list reads as follows, with the 
function of the corresponding modules indicated in parentheses: 
10 (Invoke SCP INFO) 
20 (Validate the system storage and calculate the top 
of storage) 
30 (Initialize the IPL WTO facility for the system 
console) 
40 = (Build the device support modules list) 
41 (Determine the DAT-on nucleus and the nucleus 
module Csects for the nucleus) 
05 (Create the DAT-on nucleus map) 
02 (Load Dat-off and Dat-on nucleus) 
04 (Initialize the VSM control blocks) 
06 (Initialize the RSM control blocks) 
O07 (Update the AMODE bit for the SVC and ESR 
table entries) 
03 (Initialize the UCB for the IPL processor) 
99 = (IPL cleanup in preparation for invoking NIP) 


C 


Extended Description Module Label! 


Passing Control to [RIMs 


Beginning with ‘02’, the first entry in the suffix list in the 
IVT, IEAIPLOO: 


@ Constructs the full name of the IRIM to be invoked by 
appending the identification number to ‘JEAIPL’. 

@ Reads the directory entry for the IRIM by issuing 
ISVCFIND (IPL SVC 5). 
Clears the frame into which the IRIM will be loaded. 


@ Loads the IRIM into storage, using the module loading 
service ISVCLOAD (IPL SVC 6). Address constants 
within the IRIM are relocated with respect to the virtual 
address of the IRIM area. 


e@ Issues ISVCSYNC (IPL SVC 10) to call the IRIM at its 
linkage editor-assigned entry point in supervisor state, 
key O, disabled, and with address translation on in 31-bit 
addressing mode. Registers contain the following: 


— Register 1 — virtual address of the IVT 
— Register 13 — address of an 18-word save area 


— Register 14 — address of ISVCEXIT (IPL SVC 3) 
which the IRIM must issue to return to |[EAIPLOO 


— Register 15 — entry point address of the IRIM. 


Each IRIM called, except for the last one, returns control to 
1EAIPLOO, which gets the next IRIM ID in the suffix list 
and repeats the loop. The last IRIM, IEAIPL99, passes 
control to IEAVNIPO instead of returning to JEAIPLOO. 


If one of the following errors occurs, IEAIPLOO loads wait 
state code X‘075’ in PSW bits 52-63 and a reason code in PSW 


bits 40-43. 
Error Reason Code 
JEAIPLO1 was not found. 1 
IEAIPLO1 is larger than the 2 
IVTIRIML field. 


JEAIPL99 returned to IEAIPLOO 


An IRIM other than IEAIPLO1 was 
not found. 


The IRIM is larger than a page. 5 
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Diagram 1. Initial Program J.oader (JEAIPL0O) Part 5 of 18 
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Diagram 1. Initial Program Loader (IEAIPI.00) Part 6 of 18 


Extended Description Module Label 


F  ~=IEAIPL10 issues a SCP INFO service call instruction IEAIPL10 
to obtain the storage address range constant, the stor- 

age address increment constant, and the load parameter 

from the service processor. The load parameter will be 

moved into IVTPARML. If the service call is not sup- 

ported on the processor, IEAIPL10 issues an MSSF SCP 

INFO diagnosis command. 


If either of the following problems occur, [IEAIPL10 enters 
a wait state: 


@ The Service processor is busy or not active, or the MSSF 
diagnose command is rejected. 


e |EAIPL10 has made three unsuccessful attempts to access 
a service processor through either command. 


If processing is successful, IEAIPL10 returns to JEAIPLOO. 


G JEAIPLOO calls IEAIPL20 to validate the system storage |IEAIPL20 
and place all valid frames on the available frame queue. 

IEAIPL20 calculates the top of storage, and switches dynamic 

address translation (DAT) off to access the frames. IEAIPL20 

queues all valid frames on the available frame queue, then 

switches DAT on again. 


|IEAIPL20 then moves the segment table for the master 
scheduler address space above the 16-megabyte line, and 
returns to IEAIPLOO. 


J =«IEAIPLOO calls IEAIPL30 to block load the DAT-off IEAIPL30 
nucleus into real storage and scatter load the DAT-on 

nucleus into virtual storage backed by real frames. 

|EAIPL30 also initializes the DAT-off to DAT-on linkage 

table, which establishes a communications area for the DAT-on 

and DAT-off nucleus. 


8  IEAIPLOO cal!s IEAIPL 40to build a nucleus map IEAIPL40 
(NUCMAP), which resides directly above the DAT-on 
nucleus. 


C Cc 


Extended Description Module Label 


Q _IEAIPLOO calls the input/output supervisor (IOS) IRIM, JEAIPL41 
IEAIPL41, to locate and initialize the unit control block 
(UCB) for the IPL device. 


After the hardware IPL sequence is completed, a!l subchannels 
except for the IPL subchannel! are disabled. The JOS IRIM 
obtains from the subchannel the device number (SCHDEVNO) 
that the operator specified as the number of the |PL device 
and searches the UCB chain to find the UCB for the device. If 
the 1OS IRIM cannot find the UCB, or if the UCB is not for a 
DASD or is for a non-base exposure of a multiple exposure 
device, the 1|OS IRIM puts the system in a wait state with a 
code of X'031'. Otherwise, the |OS IRIM initializes the 
following fields in the UCB: 


Field Initialization value 

UCBSID Identifier of the subchannel 

UCBPRES Permanently resident flag (set to ‘1’ B) 

UCBSYSR System residence flag (set to ‘1’ B) 

UCBVOLI Volume serial number of the system 
residence volume 

UCBVTOC TTR of the VTOC for the system 
residence volume 

UCBCHAN Address of the channel used in the IPL 
procedures 

UCBLPM Logical path mask 

UCBNOCON Not-connected flag field (set to ‘0’B 
which indicates that the device is 
connected) 


IEAIPLO3 also modifies the IPL subchannel to initialize the 
SCHIP field with the address of the UCB for the IPL device. 


1Q IEAIPLOO calls IEAIPL41to build a nucleus map IEAIPLOS 
(NUCMAP from the information contained in the 

nucleus load list, CESD entries and relocation tables. The 

NUCMAP is built in the ready only extended section of the 

nucleus region. 
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an IRIM 


Input Process Output 





11 Load the DAT-off nucleus 
into real storage and the 


DAT-on nucleus into IEAIPLO2 
virtual storage. 


Load DAT off 


and DAT-on 
nucleus 





Initialize the system 
queue area (SQA), the 
extended SOA, and the 


extended local SQA (ELSQA). | IEAIPLOA. 
Virtual storage IEAIPLO4 


NUCMAP 










VSM IRIM 





CVTNUCMP 





CVT 


CVTABEND 
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Initialize the page frame table 
and build the RSM internal 
table (RIT), the RSM address 
space block (RAB), and the 


RAB extension (RAX). IEAIPLO6 


Initialize RSM 


SCVT 
SCVTSVCT 


SCVTSVCT 






SVC table 


SVCTP 


SVCESR 
CC 


control blocks SVCEP 


SVCAMODE 


ESR table 





Initialize the AMODE bit 
for SVC types 1, 2, and Gin 
the SVC and ESR tables. [EAIPLO7 
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ESR table 





control IRIM 
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Diagram 1. Initial Program Loader (IEAIPLOO) Part 8 of 18 


Extended Description Module Label 


11. IEAIPLOO calls IEAIPLO2 to block-load the DAT-off JEAIPLO2 
nucleus into real storage and scatter-load the DAT-on 

nucleus into virtual storage backed by real frarnes. It re- 

solves external references in the modules that are loaded 


into the DAT-on nucleus. 


12 JEAIPLOO calls the virtual storage management (VSM) 
IRIM, lEAIPLO4, to allocate storage for the system queue 

area (SQA), the extended SQA (ESQA), and the extended local 

SQA (ELSQA). It builds VSM control blocks in these areas. 


IEAIPLO4 


13 IEAIPLOO calls the real storage management (RSM) 

IRIM, 1IEAIPLOG, to initialize the page frame table. 
IEAIPLOQ6 also builds the RSM internal table (RIT), the 
RSM address space block (RAB), and the RAB extension 
(RAX) for the master scheduler address space. 


IEAIPLO6 


14 IEAIPLOO calls the supervisor control |RIM, IEAIPLO7, 
to update the AMODE bit of the nucleus-resident SVC 

entries located in the SVC and extended SVC 

router (ESR) tables. These tables contain one eight-byte entry 

for each SVC routine. |EAIPLO7 sets the AMODE bit for the 

SVC entries (types 1, 2, and 6) that reside in the DAT-on 

nucleus. A later routine (IEAVNPSS5) will set the AMODE 

bit for the SVCs (types 3 and 4) that will reside in the LPA. 


|EAIPLO7 


IEA{PLO7 loops successively through the SVC and ESR 

table entries looking for SVC types 1, 2, and 6. 
SVCESR=’0’B identifies entries in the SVC table, 
SVCESR='1'B identifies entries in the ESR table, and SVCTP 
identifies the type of SVC. 


@ For non-ESR entries in the SVC table of type 1,2, and 6 
(SVCTYPE), IEAIPLO7 uses the nucleus map service 
NUCKLUP to find the AMODE of the CSECT containing 
the entry point pointed to by the SVC entry. |IEAIPLO7 
then sets theAMODE bit in the SVC table equal to the 
AMODE bit of the entry in the NUCMAP. 


Cc 


Extended Description Module Label 


e For ESR entries of types 1,2, and 6, |EAIPLO7 determines 
the address of the table and the number of entries in the 
table. For each entry in the ESR table, 1EAIPLO7 uses 
the nucleus map service NUCLKUP to find the AMODE 
of the CSECT containing the entry point pointed to by 
the ESR entry. |IEAIPLO7 then sets the AMODE bit in 
the ESR table equal to the AMODE bit of the entry in 
the NUCMAP. 


If NUCLKUP does not find a name in NUCMAP to match 
the name of the SVC or ESR table entry, then IEAIPLO7 
issues a disabled wait state code of X’077’. 


For a description of the NUCLKUP service routine, 
see SPL: System Macros and Facilities. 


Cr 
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IVTPARML 





SCHDEVNO 













SCHLPN 


CVTUCB 


IEAVNIPO 






UCB's 
for system 
Gevices 


IEAIPLO3 


initialize UCB 
for IPL device 
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IPL cleanup 


Output 


CVTUCB 


UCBPRES 


UCBSYSR 


UCBVOLI 


UCBVTOC 


UCBNOCON 


UCBLPM 
UCBSID 


UCBCHAN 





Wa] go Apiodorg — syetiazyey] pasucory 


AGT JO SPEMSIEIA, PII SOY, 


L861 ‘T8361 “sod Wal WssAdog © -007I-8Z7AT 


uonesadg Jo poy. “Ss UOTpaS 


SI-S 


Cc 


Diagram 1. Initial Program |,oader (IFAIPLO0) Part 10 of 18 


Exstended Description Module Label 


15 |IEAIPLOO calls the input/output supervisor (IOS) IRIM, IEAIPLO3 
|EAIPLO3, to locate and initialize the unit control 
block (UCB) for the IPL device. 


After the hardware IPL sequence is completed, all sub- 
channels except for the [PL subchannel are disabled. The 
JOS 1R!M obtains from the subchannel the device number 
(SCHDEVNO) that the operator specified as the number of 
the IPL device and searches the UCB chain to find the UCB 
is not for a DASD or is for a non-base exposure of a multiple 
exposure device, the IOS IRIM puts the system ina wait 
state with a code of X’'031'. Otherwise, the 1OS IRIM 
initializes the following fields in the UCB: 


Field initialization value 

UCBSID Identifier of the subchannel 

UCBPRES Permanently resident flag (set to ‘1’ B) 

UCBSYSR System residence flag (set to ‘1' B) 

UCBVOLI Volume serial number of the system 
residence volume 

UCBCHAN Address of the channel used in the IPL 
procedures 

UCBLPM Logical path mask 


UCBNOCON Not-connected flag field (set to ‘0’ B 
which indicates that the device is con- 
nected) 


16 IEAIPLOO calls IEAIPL99 to clean up the [PLenviron- IEAIPL99 
ment in preparation for passing control to NIP, the 

second phase of system initialization. [EAIPL99 places IPL 

information into common storage so the NIP can access it, 

initializes storage management, and establishes the available 

frame queues. It establishes addressability for NIP and frees 

the storage occupied by the IPL modules and workarea. 
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2 Save the resume data 
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3 Pass control to the 
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Register 1 





a. ISVCXDAP {IPL SVC O) 
executes a direct access 
channel program. 





SEEK address 





Register 1 


wait state. 


IPL SVC 
stack area 
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PSW and 
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Other stack 
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b. ISVCWAIT (IPL SVC 1) oA | 0000 Reason 
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40 


Wait state 
code 





Wa] Jo Avadoig — syeiiajeyAy pasuzor7y 


WG] JO Speuayeyy) paystaysay, 


L861 ‘7861 “S30 Wa 18UAdoD © p-00ZI-87AT 


uoneJadg Jo poylaj) “¢ UoT~aS 


LI-S 


Cc 


Diagram 1. Initial Program Loader (IEAIPL0O) Part 12 of 18 
Extended Description Module Label 


Whenever this module or an IRIM issues an IPL SVC instruction, 
the hardware loads the address of JEAIPLOO’s IPL SVC inter- 
ruption handler (entry point SVCFLIH within this module) 
from the IPL SVC new PSW. Asa result, SVCFLIH gets 
control to process the SVC request. 


1 If the IPL SVC number is one that has not been defined, IEAIPLOO  SVCFLIH 


SVCFLIH loads wait state code X‘074' and reason code 
1 in the PSW. 


2 When processing all IPL SVC instructions except IPL 

SVC 3, SVCFLIH saves the information required to 
Properly resume the interrupted program in a 32-byte entry 
ina IPL SVC stack. Each entry contains: 


e The SVC old PSW at the time of the interruption 
e The IPL SVC number 


@ Thecontents of registers 1 through 5 at the time of 
the interruption 


An IPL SVC 3 instruction needs no stack entry because the 
issuer of the IPL SVC 3 instruction is requesting return to 
the routine that issued the IPL SVC at the top of the stack. 
The necessary resume data is already stored there. 


Note that maintaining the SVC stack allows IPL SVC routines 
to issue other IPL SVCs: that is, IPL SVC requests can be 
nested. When nesting exceeds the dimensions of the stack, 
SVCFLIH enters a wait state code of X’074’ in the PSW. 


C C 


Extended Description Module Label 


3  Toroute control to the requested IPL SVC subroutine, SVCROUTE 
SVCFLIH issues the IPL SVC number as an index into 

an internal branch table. If the IPL SVC number is undefined, 

SVCFLIH loads wait state code X’074' in the PSW. Each 

SVC subroutine is described below: 


a. ISVCXDAP (IPL SVC 0) XDAPSVC 


ISVCXDAP starts a channel program to execute a 
direct access channel program to the |PL volume. 

The channel program must contain only format-1 CCWs 
and should not contain SEEKs or use data chaining. 
The initial SEEK CCW is prefixed to the requestor’s 
channel program by this service. All addresses in 

the channel program must be real addresses. 


b. ISVCWAIT (IPL SVC 1) WAITSVC 


ISVCWAIT puts a processor in a disabled wait state. It 
stores the contents of register 1 in the instruction ad- 
dress section of a PSW that has the wait bit on and 
that is disabled for |/O and external interruptions. 
Because this action causes the system to be placed in 

a disabled wait state, ISVCWAIT does not return to 

its caller. 
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Diagram 1. Initial Program Loader (IEAIPLOO) Part 13 of 18 


Input Process Output 
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bit address bit address 
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3 = (continued) 


c. ISVCDAT (IPL SVC 2) 
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Register 12 Register 12 
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STACKPTR oe d. ISVCEXIT (IPL SVC 3) STACKPTR 
provides an exit from 
STACKH| PSW and SVCFLIH. Previous top 
registers 1-5 of stack 
Register 1 e. ISVCPGEX (IPL SVC 4) Page tables Real frames 


Parameter list 
Virtual address 
of area to 
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backs virtual storage 
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Location ‘10’ 
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Diagram !{. Initial Program Loader (IEAIPL00) Part 14 of 18 


Extended Description 


3 


Cc, 


(continued) 


ISVCDAT (IPL SVC 2) 


ISVCDAT switches translation mode. The translation bit 
in the system mask is turned on (meaning DAT-on) or off 
(meaning DAT-off) and the instruction address in the PSW 
is converted from real to virtual (or virtual to real) as is 
the address in register 12, which must be the IR|M base 
register. It uses IPL SVC 3 to return to the caller. 


ISVCEXIT (IPL SVC 3) 


ISVCEXIT returns control to the issuer of the SVC 
represented by the top element of the SVC stack. To 
do so, ISVCEXIT: 


@ Makes the top element of the SVC stack available 


@ Restores register 1-5 with the values they had when 
the top element was created 


@ Loads the PSW that had been saved in the top 
element 


ISVCPGFX (IPL SVC 4) 


ISVCPGFX backs virtual storage with real frames. If the 
page is the first within a segment, ISVCPGFX issues IPL 
SVC 11 to create a page table for the segment and connect 
the page table to the segment tables. It then backs each 
page by obtaining a frame and setting the appropriate 

Page table entry to point to it. When all pages containing 
any part of the area have been backed, ISVCPGFX uses 
IPL SVC 3 to return to the caller. The reali storage ob- 
tained might not be contiguous. 


Module 


Label 


DATSVC 


EXITSVC 


PGFXSVC 


Iq] Jo Ayadoig — sypersayeyy: posuor’] 


cINGT JO SPEMIIBIAL P9}9!4ISIY,, 


o18077 WU] Waiskg VX/SAW (QZ-S 


L861 ‘7861 “d30D Wa 1421sAdoD @ F-00ZI-8ZAT 
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3 = (continued) 
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Diagram 1. Initial Program Loader (IEAIPL00) Part 16 of 18 


Extended Description 


3 


(continued) 
ISVCFIND (IPL SVC 5) 


ISVCFIND reads a partitioned data set directory entry 
for a specified member of SYS1.NUCLEUS. It issues 

IPL SVC O to read the appropriate directory block from 
SYS1.NUCLEUS and scans it for the requested member 
name. If it locates an entry for the requested member, 

it copies the entry into the specified area and sets a return 
code of 0. Otherwise, it sets a return code of 4. It uses 
IPL SVC 3 to return to the caller. 


ISVCLOAD (IPL SVC 6) 


ISVCLOAD loads a module from SYS1.NUCLEUS into 
real storage. ISVCLOAD uses information in the dir- 
ectory entry to read the first text record into real storage 
at the offset indicated by the linkage editor. Thereafter, 
is uses information in a control record to read the text 
record that follows. To resolve address constants within 
a text record, ISVCLOAD uses the RLD record(s) fol- 
lowing each text record in conjunction with the logical 
address passed as the third parameter. If ISVCLOAD 
finds an address constant shorter than four bytes, it loads 
a wait state code of X‘076’ in the PSW. After successfully 
loading the module, ISVCLOAD puts the module’s entry 
point into register 15 and returns to its issuer using {PL 
SVC 3. 


ISVCSTOR (IPL SVC 7) 


ISVCSTOR allocates contiguous real storage. The address 
of the contiguous area is returned in register 15. The 

area returned will contain zeroes. ISVCSTOR loads a 
wait state code of X‘070’ in the PSW if the requested 
number of contiguous frames cannot be found. 


Module 


Label 


FINDSVC 


LOADSVC 


MSSFCALL 
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Process 


3 = (continued) 


i. ISVCCNVT (IPL SVC 8) 
converts aSYS1.NUCLEUS 
TTR address to a CCHHR 
address. 


j. ISVCSSCH (IPL SVC 9) 
starts the IPL subchannel 
and checks its status. 


. ISVCSYNC (IPL SVC 10) 
builds and loads a 
PSW. 
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|. ISVCCSEG (IPL SVC 11) 
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Caller 





Output 


CCHHR area 


Translation 


of TTR address 





IRB 


| 


Register 15 


PSW 





Return Wait state 
code code 
40 52 63 
Instruction 
address 





Register 1 Register 15 


Address of Entry point 
parameter list address 


Page tables Segment tables 





Wa] Jo Aytadoig — spetsayeya] pasuzory 


«WG JO Spetare yA] p2}9149S9y, 


L861 ‘7861 ‘dl0g Wal W8Uhdoy © p-O0ZI-8ZAT 


UoTeladQ Jo poy, ‘Ss UOT_aS 


tc-s 


k. ISVCSYNC (IPL SVC 10) 


Cc 


Diagram 1. Initial Program Loader (IEAIPLOO) Part 18 of 18 


Extended Description Module Label 
3 2 (continued) 
I. ISVCCNVT (IPL SVC 8) CNVTSVC 


ISVCCNVT converts the TTR address (the relative ad- 
dress of the record within the data set) of aSYS1.NUCLEUS 
member to a CCHHR address (the actual address of the 
record on a DASD}). To compute the CCHHR address, 
ISVCCNVT uses the data set’s starting CCHHR address 
(taken from the format 1 DSCB for the data set), the 
number of tracks per cylinder (taken from the format 
4 DSCB), and the TTR address passed as a parameter. 

j. ISVCSSCH (IPL SVC 9) SSCHSVC 

ISVCSSCH starts a channel program, waits for the |/O 

to complete, and determines the subchannel status. It 

uses the operation request block (ORB) as an operand 

on the Start Subchannel instruction. If the subchannel 

Starts successfully, ISVCSSCH uses IPL SVC 10 to put 

the processor in a wait state enabled for I/O interruptions. 


After an |/O interruption from an IPL device, ISVCSSCH 
retrieves the subchannel status by issuing a Test Sub- 
channel instruction. The instructions’ operand is the 
interrupt response block (IRB), which was passed as the 
second parameter. If ISCVSSCH does not detect an 
exception, ISVCSSCH returns a code of 0. If a unit check 
occurs, ISCVSSCH returns a code of 4. If any other ex- 
ception occurs, ISCVSSCH causes the processor to enter a 
disabled wait state with a wait state code of X‘003’, 
X‘074' with reason code 4, or X‘074’ with reason code 5. 
Unless processing results in a disabled wait state, 
ISVCSSCH returns to its issuer. 


SYNCHSVC 


ISVCSYNS builds and loads a PSW. ISVCSYNC con- 
structs the PSW from the input, loads the parameter list 
address in register 1 and the entry point address in 
register 15, then loads the PSW. Ejther the requested 
routine receives control, or the system enters an enabled 
wait state. IEAIPLOO uses ISVCSYNC to pass control to 


Extended Description Module Label 


IRIMs and to load enabied wait PSWs. If an IRIM issues 
an IPL SVC 3 after an IPL SVC 10, control will return 
to the issuer of SVC 10. 

l. ISVCCSEG (IPL SVC 11) CSEGSVC 

ISVCCSEG creates segments by building page tables for 

all segments containing any part of the specified area and 

connecting these tables to the segment table. The para- 

meter list consists of two words: the starting virtual 

address of the area for which ISVCCSEG is to build page 

tables and the length of the area. Segments that already 

exist are ignored. 


Recovery Processing: Processing Program 
Check Interruptions 
When a program check occurs in this module or in an |RIM, PCFLIH 
the hardware loads the address of the program check inter- 
ruption handler (entry point PCFLIH within this module) 
from the program check new PSW. Asa result, PCFLIH 
receives control to process the interruption. 


lf a page or segment exception occurs, PCFLIH issues an IPL 
SVC 4 to back the page containing the failing address, then 
returns control to the point of jnterruption. 


If an addressing exception occurs, PCFLIH examines the in- 
struction causing the exception. If it is a test block instruction, 
PCFLIH sets the condition code field in the old program check 
PSW to 3, informing the issuer of the instruction that the - 
block of storage being tested is not online. PCFLIH returns to 
the point of interruption. 


When the instruction causing the address exception is not the 
test block instruction, or when a type of segment exception, 
or address exception occurs, PCFLIH loads a wait state code 
of X‘019’ in the PSW and enters a disabled state. 
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Diagram 2. Allocate IPL Message Queue Header (IEAIPL30)/Load IEAIPL35 Part 1 of 6 
IEAIPL30 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: IRIM that loads IEAIPL25, the IPL WTO facility module. 
FUNCTION: 
Bring IEAIPL35 into storage and allocate tha IPL Message 
Queue Header (MQH). 
ENTRY POINT: IEAIPL3O 
PURPOSE: Main entry point of the module. 
LINKAGE: LPSW. 
CALLERS: IEAIPLOO. 
INPUT: IVT - IPL Vector Table. (Pointed to by register 1 on entry.) 
OUTPUT: 
Module IEAIPL35 loaded into the IPL workspace. 
IPL Message Queue Header allocated from the IPL 
workspace. 
EXIT NORMAL: Return to caller via register 1¢. 
OUTPUT: See above. 
EXIT ERROR: Disabled wait state. 
EXTERNAL REFERENCES: 
ROUTINES: IEAIPLOO SVC Routines. 


CONTROL BLOCKS: 
Common name Macro Name Description 


IVT IHAIVT IPL vector table 

MQH IHAMQH IPL messages queue heacer 

PDS IHAPDS Partitioned cata set directory entry 
PGTE IARPGTE Pages taole entry. 
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IEAIPL3O - MODULE OPERATION 


. Obtain sufficient virtual storage for the IPL Message 
Queue Header (MQH). This storage 1s taKen from the IPL 
workspace. 


. Save the virtual address of the MQH in the 
IPL Vector Table (IVT). 


. Obtain sufficient contiguous virtual storage for 
IEAIPL35. This is also taken from the IPL workspace, 
and is obtained such that the first byte is on a page 
boundary. 


. Obtain sufficient contiguous real storage for 
IEAIPL35. Note: ISVCLOAD requires that the real storage 
into which a module is loaded be contiguous. Thus, 
the virtual storage used to hold IEAIPL35 will be 
backed by the contiguous real frames obtained here. 


. Set up the page table so that the virtual storage that 
will be used to hold IEAIPL35 is mapped on to the 
contiguous real storage obtained above. The page table 
entries are located by attempting to load the real 
address of each (virtual) page that will be used to load 
IEAIPL30. All of the page table entries for these pages 
are invalid, having not yet been backed by (real) 
frames. When the execution of a LRA instruction cannot 
be completed due to an invalid page table entry, the 
real address of the invalid entry is returned. The page 
table entry so located can thus be filled in with the 
next (real) frame address and marked as valid. 


. Issue ISVCLOAD to load IEAIPL35 into the real 
storage obtained. 


. Save the entry point address of IEAIPL35 in the IVT. 
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Diagram 2. Allocate IPL Message Queue Header (IEAIPL30)/Load IEAIPL35 Part 3 of 6 
IEAIPL30 - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAIPL30 
MESSAGES: None 
ABEND CODES: None 


WAIT STATE CODES: 


Wait state Reason Description 
Code Code 


X*'055' X'005' The PDS entry for module IEAIPL55 
in SYS1.NUCLEUS could not be iocated. 


X'072' None The amount of storage needed to 
either allocate the IPL Message Queue 
Header or load IEAIPL35 exceeds the 
amount available in the IPL 
workspace. 


X'074' X'006' IEAIPL30 has received an unexpected 
return code from a Load Real Address 
(LRA) instruction. 


RETURN CODES: None 


REGISTER CONTENTS ON ENTRY: 


Register 0 Irrelevant 
Register 1 - Address of the IVT 
Registers 2-12 Irrelevant 


Address of a standard save area 
Return address 
Entry point address 


Register 13 
Register 14 
Register 15 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 


Registers 0-15 ~ Restored to values present on entry. 
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Diagram 2. Allocate IPL Message Queue Header (IEAIPL30)/Load IEAIPL35 Part 4 of 6 


IEAIPL35 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: IPL WTO (Write To Operator) facility module. 


FUNCTION: 


Places a message passed by the caller on the IPL/NIP 


message queue. 


ENTRY POINT: IEAIPL3S 


PURPOSE: Main entry point of the module. 


LINKAGE: BALR via PL/S macro IPLWTO. 


CALLERS: IPL resource initialization modules (IRIMs). 


INPUT: 


IEAIPL35 is passed the address of a parameter list 
in register one. The parameter list contains: 


. Address of the message text. 


. Length (in bytes) of the message text. 
. Flag indicating whether this is a Write To Operator (WTO) 


or a Write To Log (WTL). 


. Address of the IPL Vector Table (IVT). 


OUTPUT: None 


EXIT NORMAL: Return to caller via register 14. 


EXIT ERROR: 


OUTPUT : 


. System is placed in a wait state with 


wait state code X'072'. 
EXIT ERROR: 


OUTPUT : 


. System is placed in a wait state with 
wait state code X'074¢', reason code X'007'. 


EXTERNAL REFERENCES: 
ROUTINES: None 


CONTROL BLOCKS: 
Common name/Use Macro Name 


IVT (R»AN) LTHAIVT 
MQE (C,»R»W) IHAItNQ 
MQH (RW) IHATHQ 


NWTOHDR (C>R>W) IEAPMNIP 


Description 


IPL Vector Table. 


IPL/NIP Massaga Queue Element. 


IPL/NIP Message Queue Header. 
NIP parameter list mappings. 


Legend - C=Create, R=Read, W=Write, D=Destroy 
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Diagram 2. Allocate IPL Message Queue Header (IEAIPL30)/Load IEAIPL35 Part 5 of 6 
IEAIPL35 - MODULE OPERATION 


At IPL time (which is defined to be before IZAVNIPO gets 
control) console communications are unavailable. Therefore, 
IEAIPL35 does not actually write to tha console. Instead, 
messages issued at IPL time ara saved in the IPL/NIP Messace 
Queue (IMQ). The messages so saved are written to the NIP 
console by IEAVNIPM after the NIP console nas been 
initialized. 


A detailed description of the processing done by IEAIPL35 
follows. 


. Verify the input parameters. If any errors in the 
passed parameters are found, IEAIPL35 loads a disabled 
wait state with wait state code X'074' and reason coda 
X'007'. Otherwise, the parameters are valid, so the 
next step is performed. 


. If there is not enough space left in the IPL workspace 
to hold an IPL/NIP Message Queue Element (M&E), then 
IEAIPL35 loads a disabled wait state with wait state 
code X'072'. Otherwise, there is enough room, so the 
next step is performed. 


. Obtain enough virtual storage from the IPL workspace to 
contain one MQE, and initialize the new NQE. This 
initialization includes copying the messagsa text from the 
input parameter list to the new MQE and setting the proper 
bit in the NIPNTO parameter list (which is contained in the 
MQE) when the caller has requested a WIL. (For a WTO, the 
message will eventually be written, via NIPHTO, to the NIP 
console and recorded in the NIP hardcopy buffer. For a 
WTL, the message is only recorded in the NIP hardccepy 
buffer - it is not written to the NIP console.) The new 
MQE is chained on to the IPL/NIP Message Queue. 


. IEAIPL35 restores registers and returns to its caller. 
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Diagram 2. Allocate IPL Message Queue Header (IEAIPL30)/Load IEAIPL35 Part 6 of 6 


ITEAIPL35 - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAIPL35 


MESSAGES: None 


ABEND CODES: None 


WAIT STATE CODES: 


Wait state Reason Description 
Code Code 


X'072' None The IPL workspace has been exhausted. 
X'074" X'007" The input to IEAIPL35 is invalid. 


RETURN CODES: None 


REGISTER CONTENTS ON ENTRY: 


Register O - Irrelevant 
Register 1 - Address of IEAIPL35 parametor list. 
Registers 2-12 - Irrelevant 


Address of a standard save area 
Return address 
Entry point address 


Register 13 
Register 14 
Register 15 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 


Registers 0-15 - Restored to values present on entry. 


Register 0 - Unpredictable. 

Register 1 - Input to ISVCHAIT. 

Registers 2-5 - Unpredictable. 

Register 6 - Address of IEAIPL35's parameter list. 
Registers 7-11 - Unpredictable. 

Register 12 - IEAIPL35 base address. 

Register 13 - IEAIPL35 save area address. 

Registers 14-15 - Unpredictable. 

Register 0 - Unpredictable. 

Register lL - Input to ISVCHAIT. 

Registers 2-5 - Unpredictable. 

Register 6 - Address of the invalid parameter list. 
Registers 7-11 - Unpredictable. 

Register 12 - IEAIPL35 base address. 

Register 13 - IEAIPL35 save area address. 


Registers 14-15 - Unpredictable. 
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Diagram 3. Build DAT-On Nucleus (IEAIPL41) Part 1 of 3 
IEAIPL41 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: DAT-ON nucleus load table builder 


FUNCTION: 
Build DAT-ON nucleus load tables. 


ENTRY POINT: IEAIPLG41 
PURPOSE: See FUNCTION entry 
LINKAGE: LPSW 
CALLERS: IEAIPLOO 


INPUT: 
IVT - IPL vector table 
PDS directory 
CESD records from SYS1.NUCLEUS in the format described in 
the declare for 'CESDREC' 


OUTPUT: 
Updates nucleus load list, CESD list, and relocation 
factor table. 


EXIT NORMAL: Return to caller via register 14 
EXIT ERROR: Disabled wait state 

EXTERNAL REFERENCES: 

ROUTINES: IEAIPLOO SVC routines 


CONTROL BLOCKS: 
IVT - IPL vector table 
PDS2 - Pds directory entry 
NLLE - Nucleus load list element 
CESD - Composite external symbol dictionary 


TABLES: 
Relocation table (mapped 1 to 1 with CESD list) 
~ Address table (load address of each control section) 
-~ RLF table (relocation factor of each control section) 
CESD table 
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Diagram 3. Build DAT-On Nucleus (IEAIPL41) Part 2 of 3 


IEAIPL41 - MODULE OPERATION 


1. Determine which DAT-ON nucleus is to be loaded. 


2. Construct the module name of this dat on-nucleus. 
Builds a nucleus load list element for the 
DAT-ON nucleus, and chains it to the nucleus load 
list created by IEAIPLGO. 


3. For each element in the nucleus load list coes 
the following: 


- Reads the associated pds directory for each 
module. 

- Reads all associated composite external symbol 
dictionary (CESD) entries. 

- Accumulate a list of all ENTRY~-POINT names 


&. The entry point names are checked to verify 
that no duplicate entry points exist. If duplicate 
names are found, messages are issued and a non- 
restartable wait-state is entered. 


5. Creates an entry in the nucleus load list element 
for each module containing the starting address and 
a pointer to the relocation factor for each control 
section. 
This is done by determining the size of each of 
four sections of the nucleus (read/write,read only, 
read only extended, & read/write extended, end 
calculating the displacement from the beginning 
of the section in which a module resides. 
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Diagram 3. Build DAT-On Nucleus (IEAIPL41) Part 3 of 3 
ITEAIPL41 - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAIPL41 


MESSAGES: 


ITEAO86W 
ITEA087W 


ITEAO88H 


IEAQ9II 


XxxKKxxxx NOt found in SYS1.NUCLEUS 
ENTRY-POINT xxxxxxxx appears in yyyyyyyy 
and z2zzzzzzz 

Nucleus requires more storage below 16 mb 
than is available 

Nucleus X selected 


ABEND CODES: None 


WAIT STATE CODES: 


x'O25' 


*%'055' 


x'O71' 


K'072' 


All are non-restartable. 


An entry-point appears in more than 
one module being loaded into DAT-ON 
nucleus. 


A module was not found in SYS1.NUCLEUS 


Reason code 2. 


Virtual storage below 16 inb has been 
exhausted. 


IRIM work space exhausted. 


RETURN CODES: 


EXIT NORMAL: 


0 


REGISTER CONTENTS ON ENTRY: 


Reg 1 - Address of IPL vector table 


REGISTER CONTENTS ON EXIT: Irrelevant 
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Diagram 4. Nucleus Map Creation (IEAIPLO5) Part 1 of 3 
IEAIPLOS - MODULE DESCRIPTION 


DESCRIPTIVE NAME: DAT-ON nucleus wap builder 


FUNCTION: 
Build DAT-ON nucleus map 


ENTRY POINT: IEAIPLOS 

PURPOSE: Main ENTRY-POINT of the module 
LINKAGE: LPSW from IEAIPLOO 

CALLERS: IEAIPLOO 


INPUT : 
IVT - IPL vector table (pointed to by register 1 on antry) 
Nucleus Load List (pointed to IVTNLLEF ) 


OUTPUT: 
Nucmap - Nucleus map stored at the top of read-only 
extended nucleus 


EXIT NORMAL: Return to caller via register 14 
EXTERNAL REFERENCES: 
ROUTINES: None 


CONTROL BLOCKS: 
IvT - IPL vector table 
NLLE - Nucleus load list element 
NUCMENT - Nucleus map entry 
PDS2 - Pds directory entry 


TABLES: 

Nucleus Load List 
CESD table 
Relocation table 
Nucleus map 
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Diagram 4. Nucleus Map Creation (IEAIPLOS) Part 2 of 3 
IEAIPLOS ~ MODULE OPERATION 


5-34 


1. Access the following tables: 
Nucleus load list (NLLEs) 
- CESD entries 
- Relocation table 


and use this information to calculata tha offset 
from label to end of a csact and create an entry 
for the nucleus map. 


z. Setup pointers to the nuclous mzp and sort the 
map entries in ascending order of the addrass 


fields. 
INPUT OUTPUT 
oe eee eee eee He eee wwe ee ewww weer a @ Ge emmemwwwmwe ne ee eee ewe = 
| Nucleus map 
IVTNLLEF-> (resides at the top 
Nucleus Load List of r/o extended 
nucleus ) 
NLLCESDP-> 
CESD record 
CESD symbol Nucleus symbol 
CESD offset 
CESD flag Rsect, rmode and 


Csect size 


NLLRLOCP-> Not a csect 
Relocation tabla Csect indicator 
Address 


Nucleus symbol 
length 
virtual address 
(wath amoda 
suppressed ) 


Relocation factor 


| 
| 
l 
| 
| 
| 
| 
| 
| ancde information 
| 
I 
| 
| 
| 
| 
| 
| 


Nucleus map resices at the top of the read 
only extendad section of the nucleus 
(higher addr )¢-------- <2 9-90 n 9 rn 
NUCMAP -> | (last record) 
| 


(a list in ascending order Keyed on 
the virtual address of all csects 
and ENTRY-POINTs in the DAT-ON 
nucleus ) 


(record 1) NUCMNAME - "nucmap" 
NUCMADDR - Last entry in table 
NUCMLEN - Length of the table 
(lower addr )¢-<9---- 999 n 9 n nnn nnn rn ern 
[ (read/only extended nuclaus ) 


| 
| 
| 
| 
| 
| 
| 
| 
IVINUCMP -> | 
| 


| 


ee ee i we 


— ee oe 
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Diagram 4. Nucleus Map Creation (IEAIPLOS) Part 3 of 3 
IEAIPLOS5 - DIAGNOSTIC AIDS 

ENTRY POINT NAME: IEAIPLOS 

MESSAGES: None 

ABEND CODES: None 

WAIT STATE CODES: None 


RETURN CODES: 
EXIT NORMAL: 


REGISTER CONTENTS ON ENTRY: 


Reg 1 - Address of the IPL vector table. 


REGISTER CONTENTS ON EXIT: Irrelevant 
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Diagram 5. Load DAT-Off Nucleus and DAT-On Nucleus (IEAIPLO2) Part 1 of 3 
IEAIPLO2 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: Load DAT~OFF and DAT-GN nuclei 
FUNCTION: 


Loads Dat-off nucleus modules into contiguous real 
storage and scatter loads the Dat-on nucleus into 
virtual storage. Also establishes addressability 
between the Dat-on and the Dat-off nuclei by 
processing entries in the Dat-off nucleus linkage 
table. 


ENTRY POINT: IEAIPLO2 
PURPOSE: See FUNCTION 
LINKAGE: LPSW from IEAIPLOO 
CALLERS: IEAIPLOO 


INPUT: 
IVT - IPL vector table (pointed to by register 1 on entry) 
nucleus load list (pointed to by IVTNLLEF ) 


OUTPUT: 

Dat-off nucleus in real storage 

Dat-on nucleus in virtual storage 

Dat-on/Dat-off nuclei linkage table 

Initialized CVT fields: 
CVITDOFFE -- Dat-off nucleus end address 
CVTCOFFS -- Dat-off nucleus start address 
CVTERWNE -- Extendad read/write nucleus end address 
CVTERIMNS -- Extended read/write nucleus start address 
CVTNUCLS -- Selected nucleus id 
CVTNUCMP -- Nucleus map address 


CVTPROD -- System id 

CVTRGNE -- Read/only nucleus end address 
CVTRONS <-- Read/only nucleus start acdress 
CVTRNE ~-- Read/write nucleus end address 
CVTRHNS -- Read/write nucleus start address 
CVTSVPRC -- Service processor status 


CVTIOCID -- I/O configuration identifier 
EXIT NORMAL: Return to IEAIPLOO 
EXIT ERROR: Disabled wait state (via IPL isvcwait) 
EXTERNAL REFERENCES: 
ROUTINES: IEAIPLOO SVC routines 


CONTROL BLOCKS: 


CCN ~ Channel command word 
CVT - Communications vector table 
IHADATOF - DAT-ON/dat-off nuclei LINKAGE table 
IVT - IPL vector table 
NLLE - Nucleus load list element 
PDS2 - Pds directory entry 

TABLES: 


Relocation table (mapped 1 to 1 with CESD list) 

- Address table (load address of aach control section) 
- RI1f table (relocation factor of each control section) 
IEAVEDAT - Dat-off/Dat-on nucleus LINKAGE table 
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Diagram 5. Load DAT-Off Nucleus and DAT-On Nucleus (IEAIPLO02) Part 2 of 3 


IEAIPLO2 - MODULE OPERATION 


. Set name of Dat-off module to be loaded 

. Read PDS directory entry for that member 

- Allocate enough contiguous real frames from the 

IPL frame queue to hold the module 

Load the module into that storage 

« Loop through the Nucleus Load List and read 
each member into virtual storage. Each control 
section within each module is read into the 
storage location specified by the relocation 
table entry corresponding to the CESD list entry 
for that control section 

. The nucleus map is used to resolve external 
symbol references as the modules are raad into 
virtual storage. 

- Load modules into storage locations set up by 
IEAIPL41. 

« Initialize the Dat-on to Dat-off nucleus 
linkage table 

» Place start and end addresses of tha Dat-off, 
read-write, read-only, and extended read-write 
nuclei into the IVT 

« Place I/0 configuration identifier and system 
product information from the IVT into the CVT. 
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Diagram 5. Load DAT-Off Nucleus and DAT-On Nucleus (IEAIPLO02) Part 3 of 3 
IEAIPLO2 - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAIPLO2 


MESSAGES: 


IEAQ86W - sxHOOKO0M Not found in SYS1.NUCLEUS 

IEAQ89W - xxxxxxxx has more than 1 csect but was not 
link editied with sctr option 

IEAQ9OW - Load real address failed during IEAIPLO2 
processing 

IEAQ92I - Warning: Unresolved external reference 
YYVYVYVYY 1n module xxxxxn.x 

IEAO93I - Module x»xxx™xxxxx contains unresolved weak 
external reference yyyyyyyy - Written to the 

system log only. 


ABEND CODES: None 


WAIT STATE CODES: 

X'054' = A member that was to be loaded into the DAT-ON 
nucleus contained more than one csect and 
was not link edited in scatter format. 

%'055' = The selected nucleus member data set was not 
found in SYS1.NUCLEUS. In this module, may 
eccur only if the dat-off nucleus member was 
not found. 

%'074' = Reason code 6 - Invalid address returned from a 

load real address instruction 


RETURN CODES: None 


REGISTER CONTENTS ON ENTRY: 


Reg 1 - Address of the IPL vector table. 


REGISTER CONTENTS ON EXIT: Irrelevant 
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Diagram 6. Virtual Storage Management IPL Initialization (IEAIPL04) Part 1 of 12 


IEAIPLOO 






av 


IT 


RITPFT 
1 Allocate storage for RSM 


VT | page frame table. 
CVTERWNE 
VT 
IVTASQA 
2 Allocate storage for common 
area page tables. 
VT 


O 


IVTEASQA 3 Allocate storage in the 
extended system queue area 
(ESQA) and build VSM and 
RSM control blocks in 

this area. 


oO 


DA 
GDAESQA 


GDAESQAS 





a. RSM address space 
control block (RAB). 


b. Global data area (GDA), 


c. Fixed and pageable VSM 
workareas (VSWK), 








/ Page frame table 
NUCMAP 
Read-write RMODE=ANY 


Read-only RMODE=ANY 
Read-only RMODE=24 
Read-write RMODE=24 





-Extended subpool 239 
Unused subpool 245 
Pageable VSM workarea 


Fixed VSM workarea 
Global data area 


RSM address space block 


Common area page tables 


ASCB 


ASCBRSMA 


GDA 
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Diagram 6. Virtual Sterage Management IPL Initialization (IEAIPL04) Part 2 of 12 


Extended Description Module Label Extended Description Module Label 


IEAIPLOO calls the virtual storage management (VSM) b. The global data area (GDA) 


L861 ‘T8361 ‘FI0D WAT 1481kdoD @ ¥-00ZI-8ZAT 
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Ip-S 


IRIM, IEAIPLO4, to allocate storage for the system queue 
area (SQA), the extended SQA (ESQA), and the extended 
local SQA (ELSQA), It builds the contro! blocks that are 
required by VSM and real storage management (RSM). 


A map of virtual storage upon exit from |IEAIPLO4 is 

included at the end of this diagram as Figure 5-3, 

1 The VSM IRIM defines space immediately above the [EAIPLO4 
DAT-on nucleus for the RSM page frame table. It 

adjusts the pointer to the end of the extended read-write 

nucleus (CVTERWNE) so that the page frame table is 

included in the nucleus and places a pointer to the page 

frame table in the RSM interna! table (RIT). RSM will 

initialize the RSM page frame table in IEAIPLOG. 


2 The VSM IRIM allocates eight megabytes of virtual 
storage immediately above the RSM page frame 

table for the common area page tables. In IEAIPLOG, 

RSM will initialize the required number of page tables and, 

in IEAVNPB8, VSM frees the storage that RSM does not 

need for the common area page tables. This storage becomes 

part of the extended subpool 245. 


3. The VSM IRIM allocates 320K of storage for extended 
subpools 239 and 245 (160K for each) The VSM IRIM 

places no data in subpool 239. It allocates storage for the 

following control blocks in extended subpool 245: 


a. The RSM address space control block (RAB) 
RSM will initialize this control block in IEAIPLO6. 


IEAIPLO4 sets the address of the RAB in the ASCB and 
initializes the RAB’s control block ID. 


The VSM IRIM calculates the temporary start address 
of the extended CSA (GDAECSA) by adding the size 

of the ESQA (GDAESOAS) to the start address of the 
ESQA (GDAESQOA). It initializes a field in the CVT 
that points to the GDA and adjusts a field (EV TESQAL) 
to reflect the size of ESQA. 


The VSM IRIM initializes the following fields in the 
GDy\ (addresses are virtual unless otherwise stated): 


Field initialized initialization value 


GDAID ‘GDA’ 

GDAESQAS Size of the ESQA 

GDA&ECSA Address of the ECSA 

GDACSQA Address of the ESQA 

GDASPTT Address of subpool translation 
table 

GDAWRKAP Address of workarea for global 
pageable subpools 

GDAWRKA Address of workarea for global 
fixed subpools 

GDAPGTAD Address of common page tables 

GDAPGTSZ Size of common page tables 


System components cannot issue a FREEMAIN against 
the common page tables. 


. Two VSM work areas (VSWK) 


These are permanent work areas that VSM uses to 
process storage requests for global fixed subpools 

and global pageable subpools. Within each VSWK is a 
dynamic work area from which VSM obtains storage 
for its own variables. The VSM |IRIM initializes these 
fields in the VSWKs: 


Field initialized Initalization Value 


VSWKID “Vv SWK’ 

VSWKGDA Address of the GDA 
VSWKTOP Address of the top of the stack 
VSWKSADR Address of the stack area 
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Diagram 6. Virtual Storage Management IPL Initialization (IEAIPL04) Part 3 of 12 


Process 


4 Allocate storage for the 
non-extended private area. 


F Allocate storage for the 
system queue area (SQA). 


a. Allocate storage for 
subpools 239 and 245, 


b. Assign storage for the 
sysgen PSA and map 
into subpool 239. 


c. Back unused SQA with 
real frames. 


c 
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Diagram 6. Virtual Storage Management IPL Initialization (IEAIPL04) Part 4 of 12 


Extended Description Module Label 


4 The VSM IRIM allocates two megabytes of virtual 
storage for the non-extended private area. The IRIM 

initializes fields in the GDA and the RIT that contain 

address and size information about the private area. 


5 The VSM IRIM allocates 256K of storage just below 

the nucleus for the non-ex tended subpools 239 and 
245 128K for each). The VSM IRIM initializes it from 
the top down as follows: 


a. The VSM IRIM allocates 128K of non-extended sub- 
pool 239 starting at the start address of the DAT-on 
nucleus (CVTRWNS) and allocating down 128K. It 
places no data in this area. The VSM |IRIM then 
allocates 128K down from this point for subpool 245. 
IV TASQA points to the beginning of subpool 245, 
which js also the start address for the SQA, 


By adding the address of the start of the private area 
(GDAPVT) to the size of the private area (GDAPVTSZ) 
and comparing the sum with IVTASQA, the VSM IRIM 
can determine if the SQA overlaps the area that the 
VSM IRIM previously assigned to the private area. (See 
step 4). If there is an overlap, the VSM IRIM calls 
ISVCWAIT (IPL SVC 1) which puts the processor in a 
wait state with a code of X‘71'. 


b. The VSM IRIM calls ISVCCSEG (IPL SVC 11) to 


create the page tables for the absolute zero PSA at 
the start of subpool 239. This PSA will be used as 
the reverse prefix PSA. 


The VSM RIM updates the page table entry to point to 
absolute zero and maps the PSA that was initialized 
during system generation (also called the SYSGEN) 
PSA) to the start address of subpool 239. It sets 
IVTRPSA to point to this area. 


MAPV IRT 


Extended Deéescripticn Module Label 

c. The IRIM calls ISVCPGFX (IPL SVC 4} to back the BACKPAGE 
unassigned non-extended SQA (both subpools 239 
and 245) with real storage frames. The VSM IRIM 
sets the fetch-protected storage key for subpool 239. SETKEY 


It also initializes fields in the GDA that contain the 
size and address of the non-extended SQA and the 
start address of the non-extended CSA. 
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(AQATs) for subpools 
226, 239, and 245. 


Format the global VSM 
cell pool. 
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Initialize the AQATs for 
subpools 239 and 245. 
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Diagram 6. Virtual Storage Management IPL Initialization (IEAIPL04) Part 6 of 12 


Extended Description Module Label 


6 The VSM JIRIM continues the initialization of 

extended subpool 245 that it started in Step 3. 
It allocates storage above the pageable VSM workarea 
as follows: 


a. The address queue anchor table index (AQATINDX) INITINDX 
tables for subpools 226, 239, and 245. 


These tables contain pointers to the address queue 
anchor tables (AQATs) that the VSM IRIM will 
allocate in Step 6b. For descriptions of AQATs 
end AQATINDXs, see Volume 1 of Debugging 
Handbook. 


b. Address queue anchor tables (AQATs) for SQA and 
ESQA 


The VSM IRIM allocates space for the AQATs. The 
AQATs describe the allocation of virtual storage in 
the ESQA and SOA. The |IRIM will initialize these 
AOATs in Step 7. 


c. The global VSM cell pool 


In order to format the VSM cell pool, the VSM IRIM 
first calls the service routine NUCLKUP to obtain the 
address of the formatting routine IGVVSFMT. It 
then calls IGVVSFMT to format the VSM cell pool. 


Extended Description 
d. Unused ESQA area 


The VSM IRIM backs the unused ESQA area with 
real frames and sets the fetch-protected storage key 
for extended subpool 239. The VSM IRIM sets 
fields to point to ESQA areas as follows: 


Field initialized Initialization Value 

GDASMAD *Start of global storage manage- 
ment area 

GDASMSZ Size of global storage manage- 
ment area 

IVTE239A Address of unused extended sub- 
pool 239 

IVTE239V Size of unused extended subpool 
239 

IVTE245A Address of unused extended sub- 
pool 245 

IVTE245V Size of unused extended subpool 
245 


*The global storage management area includes the 
RSM address space block and the VSM cell pool and 
all areas in between. System components cannot 
issue a FREEMAIN macro instruction for storage in 
this area. 


7 = The VSM IRIM initializes AQATs for the ex tended 
and non-extended subpools 239 and 245. 


The VSM IRIM calls the service routine, |GVAAQAT, to 
set the AQAT allocation bits (AQATALOC) to indicate 
that 192K of storage for the SQA is allocated. 


Module Label 


BACKPAGE 
SETKEY 


INITAQAT 
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Diagram 6. Virtual Storage Management IPL Initialization (IEAIPL04) Part 8 of 12 


C 


Extended Description Module Label 
§ The VSM IRIM initializes the size queue anchor INITSQAT 
tables (SQATs) in the read-only nucleus for the 
following areas: 
e Non-extended subpool 226 
@ Extended and non-extended subpools 239 
@ Extended and non-extended subpools 245 
For a description of SQATs, see Volume 1 of Debugging 
Handbook. 
The IRIM builds dummy double free elements (DFEs), 
sets the address of the dummy DFEs in the SQAT entries, 
and enqueues the dummy DFEs on the DFE address and QDFE 
and size queues. It then initializes the following fields 
in the GDA: 
Field initialized Initialization Value 
GDAADFxx Adaress of the first DFE on the 
DFE address queue 
GDAADLxx Address of the last DFE on the 
DFE address queue 
GDASZFxx Address of the first DFE on the 
DFE size queue 
GDASZLxx Address of the last DFE on the 
DFE size queue 
GDAEADFy Addr of the first DFE on the 
extended address queue 
GDAEADLYy Address of the last DFE on the 
extended address queue 
GDAESZFy Address of the first DFE on the 
extended size queue 
GDAESZLy Address of the last DFE on the 
extended size queue 
GDASOQAT6 Address of the subpool 226 SQAT 
GDASQATS9 Address of the subpool 239 SOAT 
GDAESQT9 Address of the extended subpool 
239 SQAT 
GDASQAT5 Address of the subpool 245 SOAT 
GDAESQTS5 Address of the extended subpool 


245 SOAT 


(xx is 45, 39 or 26 for subpools 245, 239, and 226) 
(y is 5 or 9 for extended subpools 245 and 239) 


Extended Description Module Label 
Q The VSM IRIM allocates storage for the extended local 
system queue area (ELSQA) beginning at the two 
gigabyte line and assigning downward. It initializes fields 
in the IVT giving the size and address of the ELSQA. 
The VSM IRIM assigns storage for the following: 


a. Address wraparound area 


The IRIM assigns 4K bytes of storage to be unused. 
A program check will occur if this area is referenced. 


b. Private area page table area 


The IRIM assigns eight megabytes of storage to this 
area. The IRIM initializes fields in the RAB with the 
addresses of the extended and non-ex tended private 
area page table areas. 


c. Segment table 
The IRIM assigns two contiguous 4K frames of storage 
for this area. The IRIM initializes fields in the RAB 
with the address of the segment table. 


d. RSM second level table (SLT) 


The IRIM initializes fields in the RAB with 
the address of the RSM second level table. 


e. Reserve area for future AQATs (208K) 


The IRIM assign 208K of storage to this area. 
Because the LSQA size is dynamic, the VSM IRIM 
provides a stack from which VSM can draw storage 
for AQATs as needed. 
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Q (continued) 





f. Local data area. 












g. Local VSM work area. 


h. Subpool 255 AQATINOX 
i. SQATs for subpool 255. 


j. Local VSM cell pool. 


10 Initialize the extended and 
non-ex tended subpool 
255 SQATSs in extended 
subpool 255. 
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Diagram 6. Virtual Storage Management IPL Initialization (IEAIPL04) Part 10 of 12 


Extended Description Module Label Extended Description Module 


Q (continued) g. Local VSM work area (VSWK) 


f. Local data area The local VSM workarea is a permanent workarea 


The IRIM initializes the following fields in the LDA: 


that VSM uses when it processes storage requests 
for local subpools. Within the VSM workarea is 


Fisid initialized Initialization value a dynamic stack area from which VSM obtains 
LDAID ‘LDA’ storage for its own variables. The VSM IRIM 
LDAAQTST address of the reserve area for initializes the following fields in the VSWK: 
AQATs 
LDAAQTAD address of the reserve area for Field Initialized Initialization value 
AQATs VSWKID ‘VSWK’ 
LDAASCB address of the ASCB VSWKLDA address of LDA 
LDAWRKA address of the local VSM workarea VSWKGDA address of GDA 
LDAEAQAT address of the ELSQA AQATINDX VSWKSADR address of VSM stack area 
LDAAQAT address of the LSQA AQATINDX VSWKTOP address of top of VSM stack 
LDASQAT address of the LSQA SOQAT area 
LDAADF address of the first DFE on LSQA VSWKCELA address of VSM cell pool head 
address queue 
LDAADL address of the last DFE on LSQA h. Extended subpool 255 AQATINDXs 
address queue " 
LDASZF address of the first DFE on LSQA i. Subpool 255 SQATs 
size queue 
LDASLZ sve uese the last DFE on LSQA The IRIM copies the SQATs for ESLQA and LSQA 
from the read-onl leus int tended | 255. 
LDAESQAT address of the ELSQA SQAT r read-only nucleus into extended subpool 255 
LDAEADF address of the first DFE on ELSQA 7 Local VSM cell pool 
address queue 
LDAEADL address of the last DFE on ELSQA THE IRIM calls the service routine, IGVVSFMT, to 
address queue format the local VSM cell pool. 
LDAESZF address of the first DFE on ELSQA 
size queue Loe a 
The VSM IRIM initializes the extended and non- 
LDAESZL f the | 10 
eee: the last DFE on ELSQA extended subpool 255 SQATs in extended subpool 
LDASMAD io q 255. The IRIM builds dummy DFEs, sets the address 
A a ess of the storage management of the dummy DF Es in the SQAT, and enqueues the 
ar ; 
dummy DFEs on the DFE address and size queues. 
LDASMSZ size of the storage management area y 4 
LDAELIM V=V region limit for extended 
storage 
LDAEVVRG V=V high amount for extended 
storage 
LDALIMIT V=V region limit for storage below 
the line 
LDAVVRG V=V high amount for storage 


below the line 


Label 


INITSQAT 


QDFE 
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11 Initialize master scheduler 
region descriptors (RDs) and 
free block queue elements 
(FBQEs). 


e Extended and non-ex tended 
V=V region. 


@ Non-extended system region. 


e@ Empty FBQE chains for 
ex tended system region, 
extended V=R region, and 
the non-extended V=R 
region. 


e Empty FBQE chains for 
the non-extended common 
systern area (CSA,) and 
extended CSA (ECSA). 


12 Return to IEAIPLOO, 


IEAIPLOO 
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Diagram 6. Virtual Storage Management IPL Initialization (IEAIPL04) Part 12 of 12 


Extended Description Module _ Label 


11 The VSM IRIM initializes master scheduler region 


descriptors (RDs) and free block queue elernents (FBQEs): 


The IRIM initializes the non-extended and extended 
V=V region RDs. It also initializes and enqueues FBQEs 
that describe the unused storage in the non-extended 
and extended V=V region. 

The IRIM initializes RDs for the non-extended system 
region. it also initializes and enqueues an FBQE 

that describes the entire non-extended system region. 
The {RIM initializes RDs to describe empty F BQE 
chains for the extended system region, the V=R region, 
and the extended V=R region. (The RD start address 
and size fields are zero.) These regions do not exist 
above the 16 megabyte line. 

The IRIM initializes RDs describing empty FBQE 
chains for non-extended and extended CSA. There 
isno CSA or ECSA until IEAVNPB8 processes the 
CSA parameter. 


12 The IRIM sets a return code of zero and returns to 


IEAIPLOO. 
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Diagram 7. Real Storage Management JPL Resource Initialization (IEAJPL06) Part 2 of 6 
Extended Description Modules Label 


The real storage manager (RSM) IRIM, IEAIPLO6, initializes 
the page frame table. IPL has already used some frames 

for the nucleus, the PSA, the NIP module (IEAVNIPQ}), 

the system queue area (SQA), the extended SQA (ESQA), the 
extended Jocal system queue area (ELSQA), and the hardware 
system area (HSA). IEAIPLO6 accounts for all these frames 
by filling in the page frame table entries (PF TEs) to reflect 
the current use of the frames. IEAIPLO6 also initializes 

fields in the RSM internal table (RIT), the RSM address space 
block (RAB), and the RAB extension (RAX) for the master 
scheduler address space. 


1 |EAIPLOG sets the queue |D in each page frame table IEAIPLO6 [ARMI 
entry (PF TQID) to the initial value X’FE’ to indicate 
that each frame is unqueued and uninitialized. 


2  IEAIPLO6G maps the valid page tables for the master 

scheduler address space into extended LSOQA by 
computing the address of the page table entry for each valid 
segment. It puts these addresses into the page table to 
describe the page tables themselves and places the addresses 
of the frames backing the segment table into the page table 
to describe the segment table. 


3. IEAIPLO6 initializes the RSM address space block (RAB) 
and the RAB extension (RAX) for the master scheduler 
address space. IEAIPLO6: 


a. Places the address of the ASCB and the ASID in the RAB. 


b. Makes each frame queue and page control block (PCB) 
queue related to the RSM address space circular. JEAIPLO6 
makes the queues circular by placing the address of the queue 
trailer fields of the RAB. 


c. Initializes the RAX and places the address of the RAX In 
the master scheduler ASCB. 
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Diagram 7. Real Storage Management IPL Resource Initialization (IEATP1.06) Part 3 of 6 
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Diagram 7. Real Storage Management [PL Resource Initialization (IEAIPLO6) Part 4 of 6 
Extended Description Module Label 


4 The RSM IRIM maps each page table for a valid 

segment (SGTINV=0) into virtual storage by placing 
the real address of the frame backing the page table in the 
PFTE for the page tabla page. If the segment ts common 
storage, it locates the page table in the page table array in 
the extended SQA (ESQA); if the segment is private storage, 
it locates the page table in tha master scheduler extended 
LSQA. 


5  IEAIPLOG initializes the PFTEs for each frame 
currently in use as follows: 


a. The PSA: IEAIPLO6 marks the frame as permanently 
resident (PFTPERM=1), places a unique ID (X’FF’) 
in PFTFREID to indicate that the frame is not to 
be freed, and sets the PSA queue ID in the PFTE 
(PFTQID=X'FS’). 


b. The DAT-off nucleus: |EA!PLO6 marks each frame as 
permanently resident (PF TPERM=1), places a unique 
ID (X'FF’) in PFTFREID to indicate that the frame 
is not to be freed, and sets the DAT-off queue ID in 
the PFTE (PFTQID=X’‘FO’). 


c. The read-only and extended read-only nucleus: |EAIPLO6 


marks each frame as permanently resident (PFTPERM=1), 
places a unique ID (X‘FF’) in PEFTFREID to indicate that 
the frame is not to be freed, and sets the ASID value for 

the common area (PFTASID), the virtual address (PF TVSA), 
and the read-only and extended read-only nucleus queue JD 
in the PFTE (PF TOQID=X’F1’). 


d, The read-write and the extended read-write nucleus frames: 
IEAIPLO6 marks each frame as permanently resident 
(PF TPERM=1), sets PF TASID to tha ASID value for the 
common area, initializes the virtual address, places a 
unique ID (X’FF’) in PETFREID to indicate that the 
frame is not to be freed, and places the read-write and 
extended read-write nucleus queve ID in the PFTE 
(PF TQ|D=X’F2’). 


Note that the page frame table and NUCMAP are part of 
the read-write nucleus. 
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Diagram 7, Real Storage Management IPL Resource Initialization (IEAIPL06) Part 5 of 6 
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Diagram 7. Real Storage Management IPL Resource Initialization (IEAIPL06) Part 6 of 6 
Extended Description Module Label 
5 (continued) 


e. The hardware system area (HSA): IEAIPLO6 marks each 
frame as permanently resident (PF TPERM=1), offline 
(PFTOFFLN=1), places a unique ID (X’FF’) in 
PFTFREID to indicate that the frame is not to be freed, 
and sets the HSA queue ID in the PFTE (PF TQI D=X'F4’). 


f, The frames that back the module IEAVNIPO: |[EAIPLO6 
sets the virtual address, PFTASID, to the ASID value for 
the master scheduler address space, the pageable frame 
queue (PFQ) ID in the PFTE (PF TQID=X‘81’), and places 
the frames backing |EAVNIPO on the PFQ for the master 
scheduler address space. 


g. The SQA: IEAIPLO6G sets the LSQA/SOQOA flag, the 
virtual address, the PF TASID to the ASID value for the 
common area, the ID of the queue to which the frame 
returns when it is freed, and the SQA frame queue (SFQ) 
ID in the PFTE (PFTQID=X‘21’). |[EAPILOG places the 
frames backing the SQA on the SFQ. 


h, The extended LSQA for the master scheduler address 
space: IEAIPLOG sets the LSQA/SQOA flag, the virtual 
address, the PFTASID to the ASID value for the master 
scheduler address space, the ID of the queue to which 
the frame returns when it is freed, and the SFQ iD 
in the PFTE (PFTQID=X‘82’). IEAIPLOG places the 
frames backing the extended LSQA on the fixed frame 
queue for the master scheduler eddress space. 
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Diagram 8. IPL Cleanup IRIM (IEAIPL99) Part 2 of 6 
Extended Description Module Label 


To prepare to pass control to NIP, IEAIPL99 performs a 
series of miscellaneous tasks. It places IPL information, LPA 
device support module list and IPL message queue into com- 
mon storage so that NIP can access it. It initializes storage 
for the RSM and establishes the available frame queues. It 
establishes addressability for NIP and removes the IPL 
modules and workarea from storage. For a map of virtual 
storage exit from IEAIPL99. 


1 IEAIPL99, scans through the service processor SCPINFO 

configurable processor data to find the highest configur- 
able processor address (SCPCPA) and places this address in 
CVTMAXMP. 


2  JEAIPLYS allocates storage in common areas and 
copies the following IPL information so that NIP 
can access it: 


@ Service processor SCPINFO information is copied into the 
extended system queue area (ESQA) (subpool 245). 

@ The PSA that was initialized at system generation (the 
sysgen PSA) is copied into the non-extended SQA 
(subpool 245). 

@ The IPL vector table ([VT) is copied into the non- 
extended SQA (subpool 245). 

@ The device support module list (LPAL) is copied into 
ESOA. 

@ The message queue header (MQH) and message queue 
element (MQE) are copied into SQA. 


Extended Description Module Label 


3. \IEAIPL99 establishes the address ranges of preferred 

storage (storage that is set aside for long-term use). It 
allocates and initializes the RSM address increment map 
(AIM). The AIM indicates which address increments of 
real storage contain only non-preferred frames and which 
ones contain a combination of preferred and non-preferred 
frames. There is one AiM entry (AIME) for each address 
increment; an AIME consists of a header record and an: 
entry for each band in the address increment. 


a. |EAIPL99 uses the service processor SCPINFO information 
in the RSM internal table (RIT) to calculate how much 
storage is needed for the AIM. It obtains storage in the 
extended SQA (subpool 245) for the AIM. 


b. I[EAIPL99 scans the page frame table entries (PF TEs) 
for frames that are currently assigned. At this time 
In the initialization process, all frames that are currently 
assigned are considered preferred (long time use). 
IEAIPL99 initializes storage as follows: 


e if any frame in an address increment is currently 
used (PFTQID—=PFTUNIN) but is not the PSA 
(PFTQID=PFTAZN), IEAIPL99 marks the 
AIME to indicate that some storage in that address 
increment is preferred (AIMAINP=0). 

@ When an address increment contains some preferred 
frames (AIMAINP=0), IEAIPL99 creates an initial 
preferred storage area by marking all frames in that 
address increment preferred (PFTPREF=1). it then 
sets a field (AIMPREF=1) to indicate that some 
frames within the band are preferred. 
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Diagram 8. IPL Cleanup IRIM (IEAIPL99) Part 4 of 6 


Extended Description 


4 ~=Having accounted for all preferred storage, |EAIPL99 

builds the available frame queues for RSM. It begins 
by marking available both the frame that contains IEAIPL99 
and the frame that holds |EAIPL99‘s page table. It de- 
queues the frame for the module's page table from the fixed 
frame queue and marks invalid the corresponding PGTE 
(PGTINV) and decreases the fix count in the PFTE 
(PFTFXCT). 


a, !EAIPL99 uses the test block (TB) instruction to retest 
all uninitialized frames. The TB instruction returns a 
condition code that identifies the state of the frame, 
and |\EAIPL9S9 sets fields accordingly. The following 
table shows the condition code, the state of the frame 
that the code represents, and the field ;|EAIPL99 
initializes to indicate the state of the frame: 


Condition Code State of the Frame Field Set 


0 good none 

1 defective PFTBADFR 
PFTOFFLN 
PFTQID 
PFTFREID 
PFTBELOW 


PFTBADFR 
PFTOFFLN 
PFTQID 
PFTFREID 
PFTBELOW 


3. (see note) offline 


Note: Condition code 3 is not actually set by the TB 
instruction. {EAIPLOO similates this condition code 
when addressing exception occurs on a TB instruction. 


b, 


Extended Description Module Label 


[EAIPLS9 scans again through the PFTEs to locate 
available frames. An available frame is an uninitialized 
good frame. For each available frame, it: 


@ Checks the address of the frame associated with the 
PFTE to determine whether the frame resides above 
or below the 16 megabyte line 

e@ Checks the PFTE to determine if the frame is pre- 
ferred or non-preferred 


Depending on the results of these checks, IEAIPL99 
builds four RSM available frame queues by placing the 
frame on the appropriate queue. The four available 
frame queues are: 

preferred, above the 16Mb line 

preferred, below the 16Mb line 

non-preferred, above the 16Mb line 

non-preferred, below the 16Mb line 


[EAIPL99 sets pointers in the RIT to the available frame 
queue headers. It also sets the field RCEAFC to indicate 
the count of the total available frames. 


[EAIPL99 sets a field in the PFT (PFTFREID) to indicate 
which available frame queue the frame should return to 
after it is freed. This queue should be the same as the 
queue to which the frame is currently assigned. 


If any frame in a band within an address increment is 
marked online (PFTOFFLN=0), |EAIPL99 marks that 
band to indicate that some storage in that band is online 
(AIMOFF=0). 
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Diagram 8. IPL Cleanup IRIM (IEAIPL99) Part 6 of 6 


Extended Description Module Label 


5 1EAIPL99 performs the final cleanup needed before 
control passes to the second phase of the system initial- 
ization process. 


a. Because the IPL workspace is no longer useful, IEAIPL99 
invalidates the segment table entries that map this space. 


b. [EAIPL99 sets the page table entry for virtual zero to 
real zero and the prefix register to point to the PSA that 
was initialized at system generation. This action allows 
the interrupt handlers to get contro! when interrupts 
occur. 


c, IEAIPL99 issues a load PSW instruction, which passes 


control to IEAVNIPO. 
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Diagram 9. IPL/NIP Interface Routine (IEAVNIPO) Part 1 of 16 
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Diagram 9. IPL/NIP Interface Routine (IEAVNIPO) Part 2 of 16 


Extended Description Module Label 


IEAVNIPO is the first nucleus initialization program (NIP) 
module to receive control. It allocates and initializes global 
system control blocks and the processor-related control 
blocks for the IPL processor. It then prepares an environ- 
ment in the master scheduler address space that wil! allow 
the resource initialization modules (RIMs) to perform 

their functions. For a map of virtual storage at exit from 
IEAVNIPO, 


1 NIP sets up an environment for the second phase of 
the initialization process. 


IEAVNIPO 


a. NIP initializes control registers 0, 1, and 14 with the 
values indicated in Figure 5-4. 


b, NIP issues the SETLOCK macro instruction to obtain 
the CPU lock, The processor is disabled for |/O and 
external interrupts until the input/output supervisor 
(1OS) storage manager is initialized in step 4. NIP 
then calls the CMSET service to initialize the cross 
memory functions in control registers 3,4, 5, and 7. 
See Figure 5-4 for the contents of the control registers. 
Cross memory initialization must be done prior to any 
dispatcher entries or interrupt handler entries. For 
more information on the CMSET service, see System 
Logic Library. 


provides diagnostic support for hardware and software 
errors by trapping the errors. The trap routines in this 
module detect errors that occur during the execution 
of this module, stop the initialization process at the 
time the error occurs, and provide diagnostic informa- 
tion in the form of wait state codes and messages. 

NIP traps the following errors: 


NPOHKEEP 


NPOTRAPS 


Extended Description 


@ Machine checks: NIP sets a trap for machine checks 


and enables for them. NIP saves the sysgen machine 
check new PSW in NVTMCPSW and places in 
FLCMNPSW the PSW that will put the system ina 
disabled wait state with a wait state code of X’44’. 
The logical address of the IPL processor is placed 

in bits 32-47 of the wait PSW. Note that IEAVNPOG 
will restore the sysgen PSW. 

Recovery termination manager (RTM) checks: 

NIP traps requests for abnormal termination that 
occur during its processing. It saves the entry 

point address of the ABTERM routine found in 
CVTBERM in NVTRTMSA and puts the address of 


the IEAVNIPO table of RTM traps into CVTBTERM. 


Module Label 
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Diagram 9. IPL/NIP Interface Routine (IEAVNIPO) Part 3 of 16 
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instruction. Register 10 contains the address of a 
subroutine that puts the system in a wait state. 

The subroutine stores the wait state code of X‘’46’ in 
the address field (bits 56-63) of the current PSW. 
The current PSW can be displayed at the operator’s 
console. 

ESTAE: NIP traps requests for STAE or ESTAE 
(SVC 60) by saving the SVCTABLE entry for 

SVC 60 and placing in SVCEP an entry pointing to 
a NIP subroutine that clears register 15 to zero and 
returns to the caller. P 

ABEND: NIP traps request for ABEND (SVC 13) 
by moving the SVC entry in the SVC table to 
NVTABSAV and placing in SVCEP an entry pointing 
to a routine that handles ABEND requests. This 
routine stores the wait state code of X’30’ into bits 
56-63 of the PSW and a completion code, if any, into 
bits 36-47 of the PSW. If the TCB ABTERM bit 

flag (TCBABTRM) is set to 1, NIP obtains the 
completion code from TCBMCP. Otherwise, NIP 
obtains the completion code from register 1. 


For more information on l|EAVNIPO diagnostic trap 
routines, see Section 3: Diagnostic Aids. 


maximum values so that no timer interrupts will occur 
when such interrupts are enabled. 


Extended Description Module Label Extended Description Module Label! 
1 = (continued) d. NIP issues the store clock (STCK) instruction to NPOICLKS 
determine whether the time-of-day (TOD) clock is in 
@ Program checks: NIP traps program checks. During error. If the clock is in error, NIP places the system 
normal operation, the program check FLIH tries into a restartable wait state with a wait state code 
to invoke SVC 13 (ABEND) to abend the offending X'O4A’. In response to the wait state code, the 
task (during NIP, that task would be the master operator must indicate a restart. Then NIP initializes SETTODCK 
scheduler). Until SVC 13 is initialized, the sysgen the restart new PSW to point to a set clock (STCK) 
program check new PSW has the wait bit on. Thus, instruction, The STCK instruction sets the TOD 
if a program check occurs before IEAVNIPO sets clock to zero, and clears the error state. (If the clock 
up this trap, NIP places the system in a wait state. remained in an error state, a set CPU timer instruction 
NIP saves the sysgen program check new PSW and would cause a machine check and a disabled wait state.) 
replaces it with a PSW that points to a BR 10 
NtP sets the CPU timer and the clock comparator to SETTIME 


Wa go Aysadoig — syetiazeyay poesuzory 


«Ad Jo SfeH9xe]A] P97117S9 yy, 


aio] Wu] waiskg YX/SAN 0/.-C 


L861 ‘T7861 “FI0D Wa WY8thdod @ -007I-8ZAT 


Diagram 9. IPL/NIP Interface Routine (IEAVNIPO) Part 5 of 16 
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Diagram 9. JIPL/NIP Interface Routine GEAVNIPO) Part 6 of 16 


Extended Description Module Label 
1. (continued) 


e. NIP saves in the CVTMDL the processor model number 
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that it obtains from the successful execution of the 
STIDP instruction, NIP must determine what extended 
precision floating point (EPFP) capabilities, if any, 

exist and place the appropriate indicator in the CVT. 

NIP executes the load rounded, long-to-short instruction 
(LRER). If aprogram interruption occurs, NIP assumes 
that the processor does not support EPFP. If no program 
interruption occurs, EPFP hardware is present. 

NIP sets the EPFP bit (CVTXPFP) on in the CVT. 


NIP initializes the nucleus vector table (NVT), which is NPOKEEP 
the basic control block for communications and 

processing during NIP. NIP copies into fields in the NVT 

the addresses of required areas that IPL created and 

stored in the IPL vector table (IVT). 


The fields and their values (addresses are virtual unless 
otherwise indicated) are: 


Field initialized Initialization value 

NVTNVSQA number of virtual segments 
of SQA 

NVTASQA low address of non-extended 
SQA 

NVTSQANO number of SQA pages 

NVTNPOAD address of IEAVNIPO 

NVTNPONO length of IEAVNIPO 

NVTALSQA low address of master scheduler 
LSQA 

NVTLSQNO number of LSQA pages to fix 

NVTLSQAS end address of master scheduler 
LSQA 

NVTMP ‘1’ — indicating that this is a 
multiprocessing system 

NVTLPALP address of device support module list 

NVTPALL length of device support module list 

NVTMQHP address of message queue 


The IVT is no longer needed; the storage it occupies is 
freed in step 8. 
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Diagram 9. IPL/NIP Interface Routine (IEAVNIPO) Part 7 of 16 
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Diagram 9. IPL/NIP Interface Routine (IEAVNIPO) Part 8 of 16 
Extended Description Module Label Extended Description Module Label! 


2 The non-extended system queue area (SQA) contains NPOVSI @ Common system data (CSD) area 


control blocks and queues that relate to the entire 
system. IEAVNIPO allocates and clears or initializes the 
global system control blocks in virtual storage and initializes 
pointers to these control blocks. For ease of reference, the 
pointers to these areas are grouped with the areas. 


NIP allocates, clears and initializes the following areas in 
subpool 245 below 16M: 


@ Physical configuration communication area (PCCA) 


Field initialized Initialization value 

PCCAPCCA ‘"PCCA’ 

PCCACPUA Physical address of IPL processor 

PCCAPSAV Address of reverse prefix PSA 
in SQA 

PCCAPSAR Real address of reverse prefix,PSA 
in SQA 

PCCACPID IPL processor ID (in EBCDIC 
characters) 

PCCAISCE Indication of which interrupt 
subclasses on the IPL processor 
are enabled 

PCCACAFM Mask corresponding to JPL 
processor 

PCCACRGG6 Contents of control register 6 

@ PCCA vector table (PCCAVT) 

Field initialized initialization value 

CVTPCCAT address of PCCAVT 

PCCATOOP address of PCCA for IPL 
processor 


@ Logical configuration communication area vector table 
(LCCAVT) 


CVTLCCAT contains the address of the LCCAVT. 


Field initialized Initialization value 

CSDCSD ‘CSD’ 

CSDMP ‘1’ — indicating a multiprocessing 
system 

CSDCPUJS mask of processors available 
for job scheduling 

CSDCPUAL mask of processors currently 
online 

CSDCPUOL 1‘ — the count of online 
processors 

CSDMASK CSD table of processor masks 

CVTSAFF affinity masks for online 
processors 

CVTCSD address of CSD 

CVTCSDRL real address of CSD 


NIP puts a mask corresponding to the IPL processor 
into field PCCACAFM of its PCCA. It also puts a mask 
and a count into the CSD area. The fields in the CSD 
will eventually contain a cumulative mask (CSDCPUAL) 
and count (CSDCPUOL) of all online processors. At 
this time, these fields reflect only the IPL processor so 
that the memory switch routine does not dispatch work 
to the non-IPL processor. 


Cell pool anchor blocks (CPABs) 


Each CPAB contains a pre-allocated pool of cells. 
IEAVNIPO initially allocates seven CPABs. 


Field initialized Initialization value 
CPABCPID CPID for this pool 
GDACPAB address of first CPAB 
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Diagram 9. IPL/NIP Interface Routine (JEAVNIPO) Part 10 of 16 


Extended Description Module 


e Address space vector table (ASVT) 


Field initialized Initialization value 

ASVTASVT ‘ASVT’ 

ASVTMAXU Maximum users count in ASVT 

ASVTAVAI *1' — indicating that ASVTFRST 
is available 

ASVTENTY address of master scheduler’s 
ASCB in first entry 

CVTASVT address of ASVT 

CVTSHRVM address of beginning of CSA 


NIP allocates and then clears or initializes the following areas 
in subpool 239 below 16M: 


e Logical configuration communication area (LCCA) 


Field initialized Initialization value 

LCCALCCA *LCCA’ 

LCCACPUA logical address of the IPL processor 
LCCAMCR1 value of control register 1 
LCCACAFM mask for the IPL processor 
LCCATOOP logica! address of the IPL processor 


e Functional recovery routine (FRR) stack area initialized 
by system routine, IEAVTRIN. 


PSACSTK contains the address of the FRR stacks. 


e CPU and local work/save area vector tables 


ASXBSPSA points to the local work/save area vector 
table 


LCCACPUS points to the CPU work/save area vector 
table 


e Global work/save areas 


Field initialized Initialization vaiue 
CVTWSAG address of WSAG template 
CVTSPSA address of WSAG vector table 


Label 


Local work/save areas 


Field initialized Initialization value 
CVTWSAL address if WSAL 

template 
ASXBSPSA address of CPU work/save area 


vector table 


CPU work/save areas 


Field initialized Initialization value 
CVTWSAC address if CPU work/save area 
LCCACPUS address of WSAL vector table 
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Diagram 9. IPL/NIP Interface Routine (IEAVNIPO) Part 11 of 16 
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Process 


3° Initialize the PSA for 
the IPL processor. 


4 Initialize the master scheduler 
address space. 


a. Initialize the master 
scheduler task 
control block. 


b, Allocate and initialize 
buffers for the input/ 
output supervisor 
(10S). 








iECVCPRM 








lIOSVCPRM 
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TCBRV 
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Diagram 9. IPL/NIP Interface Routine (IEAVNIPO) Part 12 of 16 


Extended Description 


3. sONIP initializes the prefix save area (PSA), beginning at 

location 0, It initializes the PSA by copying addresses 
from fields in the PCCA, LCCA, NVT, and WSAC and by 
setting pointers to control blocks for the IPL processor. 
The fields initialized and their values are: 


Field {nitlalized 


PSAPSA 
PSASTOR 
PSACPUPA 


PSACPUSA 


PSACPULA, 
PSALCPUA 
PSAPCCAV 
PSALCCAR 
PSALCCAV 
PSATNEW, 
PSATOLD 
PSAANEW, 
PSAAOLD 
PSACROSV 
PSASCWA 


PSARSMSA 
FLCPNPSW 


Initialization value 


‘PSA’ 

value in contro] register 1 

physical processor address of IPL 
processor 

static physical processor address of 
IPL processor 

logical processor address of 

IPL processor 

real address of PCCA 

address of PCCA 

real address of LCCA 

address of master scheduler’s 
TCB 

address of master scheduler’s 
ASCB 

contents of control register 0 
address of supervisor control 
work/save area 

address of RSM work save area 
sysgen program check PSW 


NIP restores the sysgen program check PSW with the wait 
bit off. The ABEND routine is not able to handle program 


checks. 


Label 


NPOICPI 


Cc 


Extended Description Module Label 


4 NIP initializes the master scheduler address space. 


. NIP calls the IOS storage allocation subroutines 


NiP initializes the master scheduler’s TCB with informa- 
tion found in the NVT, LDA, and ASCB: 


NPOMS! 


Field initialized Initialization value 

TCBRD address of non-extended V=V 
region descriptor 

address of extended V=V 
region descriptor 

‘0’ — indicating non V=R 


TCBERD 
TCBERV 


ASCBRSM contains the address of the master scheduler’s 
RAB stored in the wait task’s ASCB. 


NIP frees the unused portions of extended and non- 
extended SQA subpools 245 and 239. 


NPOFSQA 


IECVCPRM 
IEC VCPRM and IOSVCPRIM to allocate and initialize |IOSVCPRM 
buffers for }OS. It then enables for 1/O and external 

interrupts by releasing the processor lock that it 

obtained in Step 1. For more information about 

1ECVCPRM and {OSVCPR\M, refer to the input/output 


supervisor section of System Logic Library. 
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Diagram 9. IPL/NIP Interface Routine (IEAVNIPO) Part 13 of 16 
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NIP trace buffers (TBUFs} 
and the NIP trace buffer 
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activate tracing. 
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CVT 
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§ Allocate and initialize 
the global system duplex 
area (GSDA)}. 






CVTGDA 
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Output 


ee 
PSATBVTV 


PSATBVTR 
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Control register 12 


[| 


NIP 
trace 
buffers 


Non-extended SQA 


GSDA 


TBVTID 
TBVTBLVL 
TBVTENTY 
TBVTNXTR 
TBVTINXTV 
TBVTBWRD 
TVBTBUFV 
TBVTBPA 
TBVTBSA 
TBVTBHA 
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JNiagram 9. IPL/NIP Interface Routine (IEAVNIPO) Part 14 of 16 


C 


Extended Description Module Label 

5 NIP allocates and initializes the NIP trace buffers and LEAVNIPO NPOITRCE 
the NIP trace buffer vector tables (TBVTs). From 

subpool 245 in the extended system queue area (ESQA), 

NIP obtains 4K of storage for each of four initial NIP trace NPOGTBVF 

buffers and four NIP TBVTs. It initializes each of the NIP 

trace buffers with the identification "TBUF’. NIP then NPOITRCE 


implicitly chains the NIP trace buffers together by placing 
the NIP TBVTs into a circular queue, The following fields 
are initialized in each of the NIP TBVTs: 


Field initialized (nitialization value 

TBVTID 'TBVT’ 

TBVTBLVL control block level number 

TBVTBUFV address of 4K buffer associated 
with this TBVT 

TBVTCR12 real address of associated buffer 

TBVTBLVL control block level number 

TBVTENTY real address of next available 
slot in trace buffer 

TBVTBWRD address of previous NIP TBVT 
on queue 

TBVTNXTV address of next NIP TBVT on 
queue 

TBVTNXTR real address of next NIP TBVT 
on queue 


Finally, NIP activates trace by loading control register 12 
with the real address of the first NIP trace buffer in the 
queue and other trace information. See Figure 5-4 for 
values in control register 12, NIP initializes the following 
fields: 


Field initialized initialization value 

TBVTBPA PASID at time the buffer became 
current 

TBVTBSA SASID at time the buffer became 
current 

TBVTBHA HASID at time the buffer became 
current 

TBVTBTB value of PSATOLD at time the 
buffer became current 

PSATBVTV address of first PBVT 

PSATBVTR real address of first TBVT 


Extended Description 


G NP allocates storage for the global system duplex 

area (GSDA), which contains copies of addresses used 
by recovery routines, It allocates the storage for the GSDA 
from the non-extended SQA (subpool 245), then initializes 
the GSDA, and turns on the validity bits as follows: 


Field initialized initialization value 
GSDAASVT address of ASVT 
GSDAASVB *1’ — indicating valid address 
GSDAPCCT address of PCCAVT 
GSDAPCCB "1’ — indicating valid address 
GSDALCCT address of LCCAVT 
GSDALCCB ‘1’ — indicating valid address 
GSDACSD address of CSD 

GSDACSDB *1’ — indicating valid address 
GSDAGDA address of GDA 
GSDAGDAB ‘1’ — indicating valid address 
CVTGSDA address of GSDA 
CVTGSDAB *1’ — indicating valid address 


Module 


C 


Label 


NPOIGSDA 
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Diagram 9. IPIL/NIP Interface Routine (IEAVNIPO) Part 15 of 16 
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Process 


> 7 Allocate and initialize the 
data extent block (DEB) 
and data control block 
(DCB) for SYS1.NUCLEUS. 


8 Load JEAVNIPM and 
exit. 


IEAVNIPM 





Output 
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Diagram 9. IPL/NIP Interface Routine (IEAVNIPO) Part 16 of 16 


Extended Description Module Label 


7  NtPallocates a data control block (OCB) and a data NPOIDEB 
extent block (DEB) for SYS1.NUCLEUS from non- 
extended SQA (subpool 245) and initializes them as 


follows: 

Field initialized initialization value 

DCBMFECP °1’ — indicating the OCB is for EXCP 

DCBDEBA address of associated DEB 

DCBOFOPN *1' — indicating a successful open 

DCBOFUEX *4' — indicating return from user exit 
to 1/O support function that invoked 
the exit 

Field initialized Initialization value 

DEBNMTRK size of SYS1.NUCLEUS (in tracks) 

DEBAPPAD address of system appendage vector 
table 

DEBAPFIN authorized program facility (APF) 
flag for SYS1.NUCLEUS 

DEBUCBA address of UCB for SYS1.NUCLEUS 
dataset 

DEBSTRCC, start address of SYS1.NUCLEUS 

DEBSTRHH 

DEBENDCC, end address of SYS1.NUCLEUS 

DEBENDHH 

DEBNMEXT number of extents for SYS1.NUCLEUS 

DEBDEBID protect key and DEB block identity 

DEBVMOD file mask 

DEBDCBB address of DCB 


Extended Description Module Label 
8 NIP makes final preparations for giving control to 
IEAVNIPM and the resource initialization modules 
(RIMs), 
@ Because the IVT will no longer be used, NIP frees the 
storage it Occupies. 


NPOEXIT 


@ NIP sets the control register O control byte in the PSA 
(PSACROCB) to the value in PSAENABL. NIP then 
issues the PROTPSA macro instruction to enable PSA 
protection. 

e NIP issuesa BLOL for IEAVNIPM. It checks the return 
code from the BLOL and proceeds as follows: 


Return code NIP procedure 
0 Load |EAVNIPM and pass contro! 
to it 

4—module not Load disabled wait state code 
found '032'X 

8—1/O error Load disabled wait state code 
during *033'X 
BLOL 

any other Load disabled wait state code 


‘059'X 
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10110 
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00 
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000000 


0 


1111111 


0 
zeroes 
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oh 


Meaning 


Reserved 

SSM suppression control — enabled 
TOD clock synchronization — disabled 
Low address protect — disabled 
Extract authorized control — enabled 
Secondary space control — enabled 
Fetch protection override — enabled 
Reserved 

4K page size, 1 megabyte segment size 
Reserved 

Malfunction alert — enabled 
Emergency signal — enabled 

External call — enabled 

TOD clock synch check — disabled 
Clock comparator — enabled 

CPU timer — enabled 

Service signal — enabled 

Reserved 

External interrupt key — enabled 
Reserved 


Reserved 

Real address of segment table 
Reserved 

4K segment table size 


Program key mask (PKM) 
Secondary address space identifier 
(SASID) 

Authorization index (AX) 
Primary address space identifier 
(PASID) 

Invalid linkage table origin (LTO) 


Interrupts from all interruption 
subclasses 0-6 — enabled 
Interruption subclass 7 — disabled 
Reserved 


Same as control register 1 


Branch tracing — disabled 

Real address of next available word in 
current trace buffer 

Address space tracing — enabled 
Explicit addressing — enabled 


Unknown 

External damage reports — enabled 
Unknown 

Validate AFT pointer — enabled 
Real address of AFT 


Figure 5-4. Contents of Certain Control Registers at Exit from IEAVNIPO 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 2 of 44 
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Extended Description 


IEAVNIPM is the main control program for the loading 
and deleting of resource initialization modules (RIMs). It 
provides diagnostic support for software and hardware 
failures that might occur during NIP processing before 
system recovery services are available. It provides the NIP 
modules and RIMs with service routines that substitute 
for functions that are not yet available in the system. 


1 ‘The first function performed by NIP in IEAVNIPM 
is to set Up an environment for the RIMs. 


a, NIP obtains storage in the non-extended SQA (sub- 
pool 245) for the nucleus vector table (NVT). It 
copies into this area the NVT fields that IEAVNIPO 
initialized. NIP initializes the following fields in the 
NVT with pointers to NIP services and other 


Extended Description 


Module Label 


Field initialized NIP Service Routine 

NV TSWAIT address of NIPWAIT service 
routine 

NVTTIME address of NIPTIME routine 

NVTUCBFN address of NIPUCBFN routine 

NVTWTO address of NIPWTO service 
routine 

NVTWTOR address of NIPWTOR service 
routine 

NVTWTOR2 address of NIPWTOR2 
service routine 

NVTNPM4 address of routine to find and 
read SYS1.PARMLIB members 

NVTCPUAD physical address of [PL 


processor 


addresses: 

Field initialized NIP Service Routine 

NVTMODMN name of last module loaded 

NV TMODEP entry point of last module 
loaded 

NVTDCBSN address of SYS1.NUCLEUS 
DCB 

NVTMOUNT address of NIPMOUNT service 
routine 

NVTOPIO address of NIPOIO service 
routine 

NVTPRMPT address of NIPPROMPT service 
routine 

NVTSENSE address of NIPSENSE service 
routine 

NVTOPEN address of NIPOPEN service 
routine 


uoTIeJadg Jo poylay “Ss UOTIAS 


S8-S 


The NVT will reside in the non-extended SQA until 
IEAVNIPX releases the NVT storage. 


b. NIP tests the time-of-day (TOD) clock on the IPL 
processor. If the TOD clock is accurate, NIP places 
the clock value in NVTTOD. Otherwise, NIP sets 
the flag field NVTFLNCK on to indicate that the 
TOD clock is not operating. In either case, processing 
continues and the reconfiguration RIM, IEAVNPOO, 
will invoke IEAVRTOD to initialize the TOD clock. 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 3 of 44 


1 = (continued) 


c. Set diagnostic traps. 
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CVTBTERM @ Recovery termination 
———___—__— management trap. 
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SVCEP for SVC 26 
trap. 
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SVCEP for SVC 56 
SVCEP for SVC 48 


e ENQ/DEQ trap. 





SVCEP for SVC 60 e ESTAE trap. 
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@ Type 3 and 4 SVC trap. 


CVTBTERM 


SVCEP for SVC 26 


SVCEP for SVC 7 


SVCEP 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 4 of 44 


Extended Description 
1. = (continued) 


c. Before system recovery routines are available, NIP 
provides diagnostic support for hardware and soft- 
ware errors by trapping the errors. NIP’s trap 
routines detect errors that might occur during NIP, 
stop the initialization process at the time the error 
occurs, and provide diagnostic information in the 
form of wait state codes and messages. For more 
information on IEAVNIPM diagnostic trap routines, 
see Diagnostic Aids: Section 3. NIP sets the 
following error traps: 


@ Recovery termination management (RTM) trap: 
NIP, in IEAVNIPO, saved the address of the 
ABTERM routine (found in CVTBTERM) in the 
NVT. NIP now must reset CVTBTERM to the 
address of the table of the RTM traps (RTMTRAP) 
within IEAVNIPM. The RTMTRAP contains 
addresses of trap routines. The module IEAVNIPX 
removes the RTM trap during NIP exit processing. 


e LOCATE SVC and XCTL trap: NIP saves the 
LOCATE (SVC 26) SVC table entry in field 
NVTLOCAT. NIP places the address of the NIP 
SVC trap in the LOCATE SVC table entry 
and changes the SVC type to 2 so that the 
contents supervisor RIM, JIEAVNPOS, will not 
alter the entry when it initializes the SVC 
table. Thus, NIP traps the LOCATE SVC 
throughout NIP processing, and calls IEAVNP12 
to issue a LOCATE for the VSAM catalog. 

The system LOCATE cannot function until 
IEAVNIPX places the address of the routine in 

the SVC table. NIP saves the XCTL (SVC 7) SVC 
table entry in NVTXCTL and places the address 

of the NIP SVC trap in the XCTL SVC table entry. 
IEAVNPOS removes the traps after the LPA is 
constructed and places the proper addresses in the 
SVC table. 


Extended Description Module Label 


Type 3 and type 4 SVC trap: NIP places the 
address of the NIP SVC trap in the address field of 


each SVC table entry for a type 3 or type 4 SVC 
routine. The contents supervisor RIM, IEAVNPOS, 
removes this trap after constructing the LPA and 
making the SVC routines residing there available. 


Machine check trap: NIP handles machine checks 
by continuing to allow the system to enter a 
disabled wait state when the machine check new 
PSW is entered. The machine check new PSW was 
initialized by IEAVNIPO. The machine check 
RIM, IEAVNPOG, removes this trap when it 
initializes the machine check handler. 


ABEND trap: NIP, in IEAVNIPO, saved the contents 
of the ABEND SVC table entry in field NVTABSAV 
of the NVT. NIP places the address of the 
NIPABEND routine in the SVC table and changes 
the SVC type to 2 so that the contents super- 

visor RIM, IEAVNPOS, will not alter the entry when 
it initializes type 3 and type 4 SVCs in the SVC 
table. IEAVNIPX removes this trap during exit 
processing. 

ENQ/DEQ trap: NIP saves the contents of the ENQ 
(SVC 56) and the DEQ (SVC 48) SVC table entries. 
NIP places the address of the NIP ENQ trap routine in 
the SVC table entries for ENQ and DEQ. The NIP 
ENQ trap clears register 15 to zero and returns to 
caller. After the global resource serialization (GRS) 
RIM, IEAVNP23, has processed, NIP will reset 

the SVC trap. 

ESTAE: NIP,in IEAVNIPO, saved the STAE/ESTAE 
(SVC 60) SVC table entry in NVTSVC6O. NIP places 
the address of the NIP ESTAE trap routine in the 
ESTAE SVC table entry and in the ESTAE branch 
entry CVTSV60. The contents supervisor RIM, 
IEAVNPOS, will reset the SVC trap and the RTM 
RIM, IEAVNPAG, will set the branch entry pointer. 
The contents supervisor RIM, IEAVNPOS, removes 
this trap after the LPA has been constructed and the 
SVC routines residing there are available. 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 5 of 44 
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1 (continued) 
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and NIPWTO DEBs. NVTDCBOC 
Ce 


LOAD THE RIMS 


2. Initializes service processor CALL 
SVC control blocks and buffers. 


IEAVNPE6 


initialize 


service processor 
CALL SVC 





Initialize control blocks for 
recovery termination manage- 
ment (RTM). 


IEAVNPAS 


Initialize 
RTM 





Initialize the machine check 
handler contro! blocks for the 
IPL processor. 


IEAVNPO6 


Initialize 
MCH for IPL 


processor 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 6 of 44 


Extended Description Module Label 


1. = (continued) 


d, NIP deletes IEAVNIPO by invoking IARVFRMN 
to free the storage it occupied and return the frames 
that IEAVNIPO occupied to the available frame queue. 


e. NIP obtains storage in the private area (subpool 252) 
for the input/output DCBs and DEBs for the NIPWTO 
services. 


Before passing control to the first RIM, NIP preloads the 
LOCATE module, IEAVNP12, so that NIP can use this 
service to locate the RIMs. NIP starts the load, branch 
and delete sequence that passes control to the resource 
initialization modules (RIMs) in the order specified in the 
suffix list. The suffix list, located within IEAVNIPM, 
contains entries of two characters which NIP appends 

to ‘IEAVNP’ to create full module names. The list ends 
with ‘XX’, which signals to NIP that all RIMs have 

been invoked. 


2 ‘The first RIM that NIP calls is the service processor RIM, |EAVNPE6 
IEAVNPE6. The service processor RIM initializes the 

control blocks initialized by the service processor CALL SVC. 

The control blocks initialized are the service processor control 

block (MSFCB) and its buffer, the service processor attention 

block (MSFAB) and its buffer, and a service processor 

recovery buffer. 


See Diagram 9. 


Extended Description 


3° ‘NIP calls the recovery termination management (RTM) 
RIM, IEAVNPAS, to initialize the RTM control blocks 
that support programs running in SRB mode. 


See Diagram 10. 


4 NIP calls the machine check handler (MCH) RIM, 
IEAVNPO6, to initialize the MCH control blocks for 
the processor. 


See Diagram 11. 
After the MCH RIM has processed, NIP restores the machine 


check entry in the RTM ABTERM routine so that normal 
ABTERM processing will begin. 


Module 


IEAVNPAG6 


IEAVNPOG 


Label 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 7 of 44 


Obtain and initialize the Installation Channe! 
Path (ICHP) and the Configuration Management 
Table (CMT). 


Initialize all subchannels and 
devices that are not direct 
access devices. 


Locate and initialize the NIP consoles. 


Initialize direct access devices. 


Open SYS1.LOGREC and 
SYS1.SVCLIB data sets. 








IEAVNP2?7 


Initialize the 
ICHP and the 
CMT 






IEAVNPO2 


Entry Point: 
IEAVNPA2 
Test availability 


of non-direct 
access devices 


IEAVNPC1 


Initialize NIP 
consoles 


IEAVNPOQ2 
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IEAVNPB2 








Test availability 
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IEAVNP76 









Locate and 
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SYS1.LOGREC 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 8 of 44 


Extended Description 


6 NIP calls the input/output service (1OS) RIM, at entry 
point, IEAVNPAZ, to initialize all subchannels and all 
devices that are not direct access devices. 


7 NIP calls NIP RIM, IEAVNPC1 to locate and initialize 
the NIP console for the system. The NIP RIM then 
establishes initial operator communication. 


After L[EAVNPC1 completes, NIP issues all of the messages 
on the IPL/NIP message queue. IPLWTOs and NIPWTOs 
that occur before a console is available are saved here. Then, 


NIP waits for the operator’s response to the "SPECIFY 


SYSTEM PARAMETERS” message and queues each line 


of the response. IEAVNPQ3 will process the response. 


8 NIP calls the 1OS RIM, at entry point, IEAVNPBZ2, to 


Initialize direct access devices. 


QQ NIP calls IEAVNP76 to open SYS1.LOGREC and uses 
the NIPOPEN service routine to open SYS1.SVCLIB. 


The following table shows the system data sets that are 


opened during NIP processing and the module that opens 


each: 


Data Set Module 

SYS1.LOGREC 

SYS1.SVCLIB 

System catalog 

SYS1.PARMLIB 

LNKLST concatenation, headed by 
SYS1.LINKLIB 

LPALST concatenation, headed by 
SYS1.LPALIB 

swap and page 
data sets 


IEAVNP76 
IEAVNIPM 
IEAVNP11 
IEAVNPO3 
IEAVNPO3 


IEAVNPOS 


ILROPSOO 


Module Label 
IEAVNPO2 IEAVNPA2 
J|EAVNPC1 

lEAVNPO2 [EAVNPB2 
IEAVNP76 

IEAVNIPM 
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y, Volume serial Device 
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— 
— 
— 





JECILK2 UCB 
—— 


VTOC TTR 
(UCBVTOC) 
Pe 








CVT 
CVTILK2 





1Q Open the system catalog. 





11 Process SYSP, LNK, 
LNKAUTH, and APF 
parameters and open 
SYS1.PARMLIB and the 

LNKLST concatenation. 





IEAVNP11 


Open system 
catalog 


Output 


CVT 


CVTCBSP 


ACBAMBL 
. Core blocks 





IEAVNPO3 


e Process SYSP, LNK, 
LNKAUTH, and APF 
parameters 

e Open SYS1.PARMLIB 


and the LNKLST 
concatenation 

e Build the LLT and 
APF tables 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 10 of 44 


Extended Description Module Label 


10 IEAVNIPM calls the VSAM RIM, IEAVNIP11, to build [EAVNP11 RDDIR 
the access method control block structure (AMCBS) 
and to open the master catalog. The VSAM RIM reads a 
SYSCATLG record from SYS1.NUCLEUS to determine the 
type of master catalog: VSAM or integrated catalog facility 
(ICF) catalog. if the master catalog is a VSAM catalog, 
IEAVNP11 reads the first ten records, which describe 
the catalog, and initializes the access method block (AMB) 
work areas. The VSAM open routine (IEAVNP1A) needs 
these work areas to build the control blocks required to 
access the catalog. If the master catalog is an ICF catalog, 
the VSAM RIM calls IEAVNP15 to read the VSAM volume 
data set (VVDS) and initialize the AMB work areas. 


The VSAM RIM calls IEAVNP1A to open the master catalog. IEAVNP1A 
IEAVNP1A constructs a control block called the access 

method block list (AMBL), which contains pointers to the 

VSAM control block structure created at this time. Core 

blocks are built to describe the storage that has been 

allocated; the address of the first core block is placed in the 

access method control block (ACB). At the end of NIP pro- 

cessing, IEAVNP1VB frees the master catalog control blocks 

used during NIP. The close code in [IEAVNP71B initiates IEAV NP11 
the creation of the catalog address space. [IEAVNP1A re- 

turns control to the VSAM RIM which returns to 

IEAVNIPM., 


41. NIP calls IEAVNPOS to check the syntax of the system IEAVNPO3 
parameters that are specified in SYS1.PARMLIB or by 

the operator. It places these parameters in PARMTAB. It 

processes the SYSP, LNK, LNKAUTH parameters, and calls 

|[EAVNPAS to process the APF parameter. It opens the 

system data sets SYS1.PARMLIB and the LNKLST con- 

catenation, headed by SYS1.LINKLIB. 
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Input Process Output 






NVTPTAB 


PARMTAB 12 Check for CLPA and CVIO 
parameters. 


NVT 
_——= 
NVTFLOS 










NVTFLWS 
———— aa 
















13 Process REAL parameter and 
initialize frames in V=R region. 


IEAVNPE8 


Process the 
REAL 


parameter 





14 Initialize global resource seriali- 
zation control blocks. 





IEAVNP23/ 
ISGNCBIM 


Initialize global 
resource 


serialization 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 12 of 44 


Extended Description Module Label 


12 NIP checks for CLPA and CVIO system parameters and IEAVNIPM 
sets flags in the NVT that ASM will reference later in 

system initialization. If the CLPA parameter is specified, a 

cold start is in process. If the CVIO parameter is specified, 

a quick start isin process. If neither parameter is specified, 

a warm start is in process. 


NIP calls the real storage management (RSM) RIM, IEAVNPE8 
IEAVNPES, to check the syntax of the REAL 

parameter, mark all of the page frame table entries (PF TEs) 

for frames in the V=R region, and mark the address increment 

map entries (AIMEs). 


14 NIP calls the global resource serialization RIM, ISGNCBIM 
IEAVNP23/ISGNCBIM, to initialize the GRS control 

blocks and process the GRS system parameters GRS, 

GRSCNF, GRSRNL, and SYSNAME. 


NIP restores the ENQ (SVC 56) and DEQ (SVC 48) entries IEAVNIPM 
in SVCTABLE. 
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Diagram 10. NIP Control and Service Routine (TEAVNIPM) Part £3 of 44 


Input Process Output 


Initialize the first set of auxiliary 
storage management (ASM) 
control blocks and open PLPA, 
common and duplex page data IEAVNPO4/ 
sets. ILRASRIM 


Initialize ASM 





Process the SQA parameter and 
build VSM control blocks to 
describe the SQA and ESQA. 





IEAVNPA8 


Initialize the remaining ASM 
control blocks and open the 
local page data sets and swap 


dat ts. 
ara sels IEAVNP14/ 
ILRASRM1 
Process the IEASVCxx member Initialize ASM 


of SYS1. PARMLIB 
IEAVNP25 


SVC PARMLIB 
Processing 
Initialize the following areas 


in virtual storage: 


IEAVNPOS 


Initialize 


e@ link pack area (PLPA, FLPA, 
MLPA) 
CVTPLPAS extended PLPA, FLPA, 


MLPA contents 
CVTPLPAE supervisor areas RITLQSA 


RITFQSA 





CVTEPLPS Clean up V=V region. RITFQSAX 
CVTEPLPE RITLOQSAX 
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Diagram 10. NIP Contro! and Service Routine (IEAVNIPM) Part 14 of 44 


Extended Description Module Label 


15 NIP calls the first auxiliary storage management ILRASRIM 
(ASM) RIM, IEAVNP04/ILRASRIM, to build and 

initialize the ASM control blocks and open the PLPA, 

common, and, if requested, duplex page data sets. 


16 NIP calls the virtual storage management (VSM) IEAVNPAS 
RIM, |EAVNPA&S, to process the SQA parameter 

and build the VSM control blocks and page tables necessary 

to describe the expanded system queue area (SQA) and the 

extended SQA (ESQOA) areas. 


17 NIP calls the second auxiliary storage management 

(ASM) RIM, IEAVNP14/ILRASRM1, to build and 
initialize the remaining ASM control blocks. The RIM also 
opens the local page data sets and swap data sets. 


18 NIP calls the supervisor control’s RIM, IEAVNP25, !EAVNP25 
to process the IEASVCxx parmlib member, install 

nucleus-resident routines and to save the spcifications for 

LPA-resident user-SVCs until IEAVNPO5 builds the LPA. 


19 NIP calls the contents supervisor RIM, IEAVNPO5, IEAVNPOS 
to initialize the following areas in virtual storage: 


e Link pack areas: PLPA, FLPA, and MLPA 
e Extended link pack area: EPLPA, EFLPA, and EMLPA 


Modules loaded into the PLPA and EPLPA areas are ob- 
tained from the LPALST concatenation headed by 
SYS1,LPALIB. I|EAVNPOS5S opens the LPALST. 


The contents supervisor RIM also initializes the authorized 
program facility (APF) table and the type 3 and 4 SVC 
routines in the SVC table. It then opens the SYS1,.LPALIB 
data set. 


20 \EAVNIPM cleans up the V=V region. IEAVNIPM 
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Process Output 


21 ~~ =Process the CSA parameter 
and build VSM control blocks 
that describe the common 
system area (CSA) and 
extended CSA. 


Initialize CSA 


IEAVNPB8 


aio] Wy waiskg VX/SAW = 86-C 


and ECSA 





ENFCFLGS 


ENFCPMOD 


ENFCVT 
ENFCDS 


Initialize the event notification IEAVNP47 


facility (ENF). 


Initialize the RSM control 
blocks and process the REAL, 
VRREGN, and RSU parameters. 





JEAVNPD8 


Initialize RSM 





Initialize the system resources 


manager (SRM) function. IEAVNP10 


Initialize SRM 


Build and initialize the SRM 
channel measurement function. 


IEAVNPIF 


initialize channel 


measurement 
function 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 16 of 44 


Extended Description Module Label 
21 = NIP calls the VSM RIM, IEAVNPBS, to process the IEAVNPB8 
CSA parameter and build the VSM control blocks 
and page tables necessary to describe the common system 
area (CSA) and extended CSA, 
22 NIP calls the event notification facility (ENF) RIM, IEAVNP47 


IEAVNP47, to initialize the ENF function. After 
IEAVNP47 finishes executing, ENF is able to process 
synchronous requests for service and to accept asynchronous 
requests. However, it cannot process the asynchronous 
requests until |EEMB860 attaches the ENF wait routine 
(IEFENFWT), which completes ENF initialization. 


To initialize ENF, IEAVNP47: 

@ Builds and initializes the ENF vector table (ENFVT). 
For each ENF event defined, ENF VT contains an entry 
relating the event to the listener. IEAVNP47 issues a 
GETMAIN to acquire enough storage from subpool! 231 
to hold entries for the maximum number of events that 
can be defined (specified in the ENFCMAX field of the 
event control table). 'EAVNP47 sets each entry in 
ENFVT to zero, places a control block ID ((ENFV’) 
in the first word, and stores ENFVT’s address in 
the ENF control table. A GETMAIN failure causes 
a wait state code of X’064’. 

@ Builds and initializes the ENF process table (ENFDS), 
which contains an event parameter list for each unpro- 
cessed asychronous ENF request. |IEAVNP47 obtains 
enough storage from subpool 239 to hold the 
maximum number of unprocessed requests allowed 
(specified by the system in the ENF DSMAX field). 
IEAVNP47 sets each entry in the ENFDS to zero, 
places the control block ID (‘ENFD’) in the first 
word, and stores ENFD’s address in the ENF control 
table (ENFCT). A GETMAIN failure causes a 
wait state code of X‘064’. 


Extended Description Module Label 


@ Loads the address of the event notification processing 
routine (IEFENFNM) into the ENF control table 
(ENFCT). 

e Indicates ENF RIM initialization is complete by setting 
a flag in the ENFCFLGS field of ENFCT. The ENFCT 
isa CSET (IERENFDM) in lEANUCO1 and needs no 
further initialization. 

e Returns to IEAVNIPM. 


23 NIP calls the real storage management (RSM) RIM, lIEAVNPD8 
IEAVNPD&, to initialize the RSM control blocks and 


process the REAL, VRREGN, and RSU system parameters. 


24 NIP calls the system resource management (SRM) RIM, IEAVNP10 
IEAVNP10, to initialize the SRM function. 


25, NIP calls the SRM RIM, IEAVNP1F, to build and IEAVNP1F 


initialize the SRM channel measurement functions. 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 17 of 44 
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Input Process 


Initialize ABDUMP. 
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tables (ASTs). 
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IEAVNIPM 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 18 of 44 


Extended Description Module Label 


26 NIP calls the recovery termination management (RTM) IEAVNPD6 
RIM, JEAVNPD6, to initialize the RTM functions that 
support task recovery {ESTAE/ESTAI). 


27 = NIP calls the ABDUMP RIM to initialize the ABDUMP IEAVNPD1 
control blocks and work areas. The ABDUMP RIM also 

initializes the default values for SYSABEND dumps, 

SYSUDUMP dumps, and SYSMDUMP dumps. 


28 NiP calls the SVC dump RIM to initialize SVC dump and IEAVNPD2 
dump analysis and elimination (DAE) control blocks and 
work areas. 


29 The NIP RIM, IEAVNPX1, builds in the non-extended IEAVNPX1 NPXRTRAP 
SGA a commonly addressable interface to all recovery 

termination management (RTM) traps. This interface is 

necessary to handle abnormal conditions occurring in 

address spaces other than the master address space. The 

RIM includes code to trap these conditions, reestablish 

the master address space, and transfer control to the NIP 

trap routines. The RIM moves this code to the non-extended 

SQA in order to make it addressable regardless of which 

address space is in control. It resets the entries of the new 

RTM branch table to the proper points within the SQA code 

(some entries point to normal RTM routines) and resets 

CVTBTERM, the ABTERM routine entry point address, 

to point to this new RTM trap branch table. 


The NIP RIM obtains space in non-extended CSA to copy NPXMPSA 
the template PSA into, sets a pointer to the template PSA 

(CVTVPSA), and frees the non-extended SQA space that 

the PSA occupied. 


30 After IEAVNPX1, NIP allows RIMs to use WTOs to IEAVNPOS 
issue messages to the NIP console. NIP calls the super- 

visor control RIM, IEAVNPOS, to initialize the address 

space vector tables (ASVTs), the address space first tables 

(AF Ts), and the address space second tables (ASTs). 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 19 of 44 
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Create and initialize the system 
trace address space. IEAVNPS1 


Initialize 
system trace 
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3, Create and initialize the global [EAVNP33/ 
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Initialize 
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Initialize 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 20 of 44 


Extended Description Module Label 


31° NIP calis the program call/authorization RIM, IEAVNPFS5 
IEAVNPF5, to create the PC/AUTH address space 
and initialize it. 


32 NiP calls the system trace RIM, JEAVNPS1, to create IEAVNPS51 
the system trace address space and initialize the 
trace function. 


33 NIP calls the global resource serialization RIM, ISGNTASC 
IEAVNP33/ISGNTASC, to initiate the creation of 
the global resource serialization address space. 


34 NiP calls the dumping services RIM, IEAVNPS7, to IEAVNP57 
create and initialize the dumping services address 
space, DUMPSRV. 


35 NIP calis the communications task RIM, IEAVNPA1, IEAVNPA1 
to process the HARDCPY, WTOBFRS, and 
WTORPLY system parameters, 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 21 of 44 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 22 of 44 
Extended Description Module Label 


36 NIP calls the data management RIM, IEAVNP16, to IEAVNP16 
build a table of user-written EXCP appendages that can 
be used by unauthorized programs. 


37 NIP calls the master scheduler RIM, IEAVNP13, to obtain IEAVNP13 
and store information that will be needed later in the 
initialization process. 


38 NIP calls the generalized trace facility (GTF) RIM, IEAVNP17 
IEAVNP17, to set up an interface with monitor call 
processing. 


39 NIP calls the master scheduler interface to the General {EAVNP18 
Parmlib Scan Routine (IEAVNP18). The interface 

initializes a parameter list, IEEZB819, and invokes the 

General Parmlib Scan Routine, |EEMB888. 


AQ NIP calls the mass storage system communicator (MSSC) IEAVNP19 
RIM, IEAVNP19, to locate and initialize any mass 
storage controllers in the system. 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 24 of 44 


Extended Description Module Label 


41 NIP calls the supervisor control RIM, (EAVNP20O, IEAVNP20 
to process the CLOCKxx parmlib member. This 
may prompt the operator to set the TOD clock. 


A2 NIP calls the 1OS RIM, IEAVNPF2, to process the 1|OS IEAVNPF2 
system parameter and obtain storage for the device 
statistics table. 


43 NIP calls the volume attribute RIM, IEAVNP15/ 1EAVAPOO 
JIEAVAPOO, to initialize the unit control blocks (UCBs) 
with information about direct access data set volumes. 


44 |EAVNIPM calls the VSAM RIM, 1EAVNP1B,toclose IEAVNP1B 
the system catalog. The VSAM RIM deletes the control 

blocks that |EAVNP1A constructed and the address of the 

ACB is removed from the AMCBS, thus closing the system 

catalog. After system initialization is complete, the first 

reference to a cataloged data set will, cause the system 

catalog to be opened. 
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' Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 26 of 44 


Extended Description Module 


‘45 NiPcalls the reconfiguration RIM, lEAVNPOO IEAVNPOO 
which initialized the IPL processor and brings the 
non-IPL processors online. 


46 NiPcalls JEAVNIPX to perform final exit and IEAVNIPX 
cleanup processing before passing control to master 
scheduler initialization. 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 28 of 44 


Extended Description Module Label 


IEAVNPM2 contains the NIPWTO, NIPWTOR, and the 
NIPWTOR2 service routines. These service routines execute 
|/O to any supported console device. They can be used by any 
NIP module. 


NIPWTO: NIPWTO writes to the NIP console, and, from IEAVNPM2 NIPWTO 
NIPWTOR as a special case, issues a WIT OR message to the 

NIP console. This routine requires, as input, a pointer in the 

parameter register to the NIP message header, immediately 

followed by the NIP message. 


1 NIPWTO calculates the length of the message passed to 

it in the NIPWTO message header and loads the message 
into a temporary work area buffer, At this time, the message 
is compressed to eliminate extra blanks unless the caller has 
specifically requested ‘no compress’’. NIPWTO then sub- 
stitutes the address of this work area for that of the NIPWTO 
message header in the parameter register. 


2 NIPWTO finds the UCB address from the input DEB. 
NIPWTO tests the NVT composite console flag, 
NVTFLIOC, to determine the source of the UCB address. 
If the flag is 1, the UCB address is found in the output DEB; 
otherwise, it is found in the input DEB. NIPWTO can 
determine the type of console device from the UCB, NIPWTO 
determines the appropriate channel program to write the 
message, or whether a display screen must be updated, Ifa 
display console is active, NIPWTO determines which type of 
console has been initialized and writes the message to the 
screen. 


3  NIPWTO returns to the caller. 
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From a NIP routine 








ora RIM 
Input Process 
NVT IEAVNPM2 
NVTFLAC NIPWTOR: 


NVTFLRAC 





NCT 
NVTFLWSE NCTECB 


Register 1 


Address of 
WTOR parameter Jist 


NVTDCBIC 









DCB DEB 
DCBDEBAD , DEBSUCBA 


UCB 


UCB3UREC 


UCBTBYT4 


UCB3COMM 







parameter fist 


| 


Address of UCMAECB 
Address of INPUTECB 













1 Check for an active 
NIP console. 


2 Check for outstanding 
read requests. 


3 Cal! NIPWTO to issue 


the message. 


4 Prepare to receive 


the operator's reply. 


& Check for asynchronous 
requests. 


6 Return to caller. 


To caller 
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NVTIDPSW 
NVTFLWSC 


NVT 
NVTIDPSW 
NVTFLWSC 


CT 










z 


NCTECB 


NPMAREA 


UCMAECB 


NVTFLRAC 


NWTORECB 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 30 of 44 


Extended Description Module Label 


NIPWTOR: NIPWTOR writes NIP messages to the master NIPWTOR 
console, initiates the read |/O for the related operator's reply, 

and optionally, enters the NIPWTORZ2 routine to await com- 

pletion of the operator’s reply. This routine requires, as 

input, a pointer in the parameter register to the NIP WTOR 

parameter list. 


1 NIPWTOR tests to ensure that there is an active NIP 

console, If there is none, NIPWTOR enters a disabled 
wait state X'O3F’, which indicates a system error has been 
diagnosed. 


2 NIP then tests for outstanding read requests. If there 
is an outstanding request, NIPWTOR enters the X’03F’ 
disabled wait state. 


3  NIPWTOR loads the message address from the WTOR 

parameter list. If the address is not zero, NIPWTO is 
called to issue the message. This message text is prefixed 
with a special character to indicate that action has been 
taken. 


4 NIPWTOR then prepares to receive the operator's reply. 

First NIPWTOR clears the reply area to blanks, then 
determines the device type, through the UCB, to set up the 
proper channel program for the read operation. Finally, 
NIPWTOR sets the field, NVTFLRAC, to indicate that a 
WTOR is outstanding. 


5 = NIPWTOR checks the field, NWTORFLA, in the para- 
meter list to determine if this is an asynchronous 


request. If it is, NIPWTOR calls NIPWTOR2 to wait for the 
operator's reply. 


G NIPWTOR returns to the caller. 
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From a NIP routine 
ora RIM 


input Process 


















Output 





NIPWTORZ2: 


Parameter register 


[| 


1 Check the value in the 
parameter register. 





@ If the value is 
negative, free the 

message-reply SQA 
buffer. 


@ if the value is 0, free the 
master-console image 
buffer. 


NVT 





elf the value is positive, 
check the validity of 
the wait request. 





NVTFLRAC 


NVTFLWSE 
ECB 
» ECBCC 


UCB 


NVTFLWSC 









NVTIDPSW 





Process the operator’s 
response. 





UCB3UREC 
3 Return to caller. 


UCB3COMM 


UCB3DISP 


UCBTBYT4 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 32 of 44 


Extended Description Moduie Label 
NIPWTOR2: NIPWTOR2 performs one of the three unique NIPWTOR2 
services depending on the value found in the parameter 

register. 


e If the value is negative, NIPWTOR 2 frees a message-reply 
SQA buffer. 


e if the value in the parameter register is zero, NIPWTOR2 
frees the master-console-image buffer. 


@ If the vaiue is positive, NIPWTOR2 waits for an operator's 
reply before it completes processing. 


1  NIPWTOR2 checks the value in the parameter register. 


e If the value is negative, it is the two’s complement of 
the address of the SQA buffer to be freed. 
NIPWTOR2 issues a FREEMAIN macro instruction 
to free the storage occupied by the buffer. 


e If the value is zero, NIPWTORZ2 loads the address of 
the master-console-image buffer into register 1 and 
issues a FREEMAIN macro instruction to free the 
storage occupied by the buffer. 


@ If the value is positive, it is the address of the 
NIPWTOR parameter list associated with the oper- 
ator’s reply that NIPWTOR must complete. NIPWTOR 
checks the validity of the wait request. If there are 
no outstanding read requests, the wait is invalid, and 
NIPWTOR enters a X‘O3F’ disabled wait state. If the 
wait returns with an unsuccessful return code in the 
ECB, NIPWTOR2 enters a X’021’ disabled wait state, 
which indicates an |/O error on the system console. 


2 NIPWTOR2 then checks for the device type and checks 
the operator's response for syntax validity. if the re- 
sponse is valid, NIPWTOR2 moves the response into NIP’s 


hardcopy message buffer in SQA, and into the caller’s reply 
buffer. 


3 NIP returns to the caller. 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 33 of 44 


Input 


Register 1 NIPMNTPL 
Address of NMNTFL1 
NIPMNTPL 
NMNTDSA 
NMNTFLB 
NMNTFUS 










NIPMNTPL 


NMNTDT 


NMNTFVS 


NMNTFLC 





UCB 
UCBPRES 


Register 1 


Address of 
NIPMNTPL 






routine ora RIM 


Process Output 











IEAVNPM3 


NIPMOUNT: 


1 Determine the type of 
request. 





Register 15 Register 1 


a 


2 Process the request 







e If direct access 
device. 


PSW 


[ 





Register 15 Register 1 


[| | Ld 






e If tape device. 





3 Return to caller. 


To caller 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 34 of 44 


Extended Description Module Label 


| EAVNPM3 processes requests to mount direct access devices 
and tape devices, and opens direct access data sets and tape 
data sets. This service is used by any NIP module. 


NIPMOUNT: 
IEAVNPM3 NIPMOUNT 


NIPMOUNT mounts direct access devices and magnetic tape 
volumes. 


1 NIPMOUNT determines from the information passed to 
it in the parameter list whether the request is for a 
direct access device or a tape device. 


2 NIPMOUNT processes the requests. 


e NIPMOUNT processes the request to mount a direct 
access device as follows: 


If the device type is correct and the volume is acces- 
sible, the operator mounts the specified volume and 
NIPMOUNT sets a return code of zero in register 15 
and the UCB address of the unit in register 1. 


If the requested volume is already mounted, but the 
device type is wrong for the specified UCB address, 
and the parameter list indicates to scan the UCBs only, 
NIPMOUNT sets a return code of four in register 15, 
and places zeroes in register 1. These registers indicate 
that the volume could not be found. 


If the requested volume is already mounted, but the 
device type is wrong for the specified UCB address, 
NIPMOUNT issues message [EA314I to inform the 
operator of the conflict. 


If the operator cannot remove the volume from the 
device because the UCB for the volume is marked as 
permanently resident, NIPMOUNT sets a return code 
of 4 in register 15 to cancel the request. If the request 
cannot be cancelled because the NMNTFLC flag is 

set inthe parameter list, NIPMOUNT enters a disabled 
wait state X'039’'. 


3 


Extended Description Module Label 


If the volume can be removed, NIPMOUNT issues message 
1IEA3121 to request that the operator vary the conflicting 
unit offine. NIPMOUNT then issues message |EA317A to 
request that the operator respecify the unit address on which 
the volume can be mounted, or to cancel the request. If the 
operator's response is not valid, NIPMOUNT issues message 
i1EA3181 to inform the operator that the response is un- 
acceptable. It continues to reprompt the operator with 
message 1EA317A until a valid response is received. 


If the operator's response is a valid address, NIPMOUNT 

issueg message |EA315A requesting that the operator mount 

the specified unit. If the specified unit is mounted, NIPMOUNT 
must read the volume label. If NIPMOUNT encounters I/O errors 
reading the volume label, it issues message |EA311I to indi- 

cate that the device was unlabled, or message [EA3071 to 
indicate that an error was encountered while reading the 

volume label. |f an error messages is issued or the unit 

specified by the operator is not correct, NIPMOUNT issues 
message [EA316A to request that the operator demount the 
specified unit, and reprompts the operator with message 
[EA315A. Once the correct unit is mounted, NIPMOUNT 

sets a return code of zero in register 15 and the UCB address 

of the unit in register 1. 


NIPMOUNT processes the request to mount a tape device 
as follows: 


If the specified unit is already allocated, NIPMOUNT sets 
a return code of four in register 15, and returns zeroes 
in register 1 to indicate that it cannot be mounted. 


If the unit is not currently used, NIPMOUNT issues 
message |EA315A requesting that the operator mount 
the specified unit. {f an I/O error is detected, 
NIPMOUNT issues message IEA3061 via the NIPSENSE 
service to inform the operator, then unloads the tape, 
and issues message |EA316A to demount the unit. 
NIPMOUNT then reprompts the operator with message 
[EA315A. Once a unit zero in register 15, and places 
the UCB address of the unit in register 1. 


NIPMOUNT returns to the caller. 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 35 of 44 


From a NIP routine 
ora RIM 


Input Process 






NIPOPEN: 










Parameter register 
Address of 1 Determine the type of 
NIPOPNPL request. 


2 Process the request 


UCB3TAPE elf tape 


data set. 
UCB20PTO 


e If direct access 
data set. 


3 Return to caller. 


To 
caller 





Register 15 


| | 


UCB 


a 
UCBALOC 
UCBPRES 


UCBDMCT 


UCBUSER 
sr 





Register 1 


Address of 


parameter list 





DEB 


Register 15 
Oor4. 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 36 of 44 


Extended Description Module Label 
NIPOPEN: 
This entry point is used by any NIP module that requires NIPOPEN 


that a data set on a direct access device or a magnetic tape be 
opened. 


1 NIPOPEN determines, from the information passed to 
it in the parameter list, whether the request is to open 

a data set on a direct access device or a tape device, and if the 

data set is permanently resident or not. The DEB that must 

be built to open a data set must reside in SQA for a per- 

manently resident data set, and in the private area for a data 

set that is not permanently resident. 


2 NIPOPEN processes the request. 


e If the request is for a data set on tape, NIPOPEN 
builds and initializes a DEB for the data set. If the 
data set is permanently resident, NIPOPEN initializes 
fields in the UCB to indicate that the tape is allocated 
and permanently resident. NIPOPEN sets return code 
of zero in register 15 and puts the parameter list ad- 
dress in register 1. 


e If the request is for a data set on a direct access 
device, NIPOPEN reads the format 1 DSCB that de- 
scribes this data set. If the format 1 DSCB was found, 
but it indicates that the data set has additional ex- 
tents, NIPOPEN reads the format 3 DSCB. 


If the format 1 DSCB could not be found, NIPOPEN 
issues message IEA3191 indicating that the DSCB was 
not found. NIPOPEN sets a return code of 4 in 
register 15 and puts the two’s complement address of 
the parameter list in register 1. 


If an 1/O error occurred while reading either DSCB, 
NIPOPEN issues messages |EA211! and |EA306I to 
inform the operator. NIPOPEN enters a disabled wait 
state X‘037’ if the DSCB was not read and the request 
is conditional, 


Extended Description Module Label 


if the DSCB was read successfully, NIPOPEN builds and 
initializes a DEB to describe the data set. If the DEB is be- 
ing expanded for a new concatenation, NIPOPEN checks 
for room in the DEB for more extents. If the DEB is full, 
NIPOPEN returns to its caller with return code of X’OC’ in 
register 15 and puts the parameter list address in register 1. 
If the data set is permanently resident, NIPOPEN initializes 
fields in the UCB to indicate that the device is allocated and 
permanently resident. NIPOPEN sets the return code of 
zero in register 15 and puts the parameter list address in 
register 1. 


3 NIPOPEN returns to thecaller. Register 1 is unchanged 
if the data set was successfully opened, 
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Input 


NIPPAREA NVT 
ee 


NVTPLNAM 












NIPPABDH 


NIPPANAM NVTPLDCB 






PARMTAB 
NIPPAFL1 


NIPPAREA 


NIPPATTR 


Process Output 


IEAV NPM4 





| Locate the specified 


SYS1.PARMLIB member. Register 15 







@ member not found NIPPAREA 














NIPPARC4 


> i. step 


e 1/0 error Register 1 Register 15 


: 
; 


NIPPAREA 
NIPPARC 


2 Convert the actual 
address (TTR) of device 
to a relative address 
(MBBCCHHR). 


e Conversion failed Register 1 Register 15 





: 
: 
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: iL step 


NIPPAREA 
NIPPARC 


Channe! program 


e Conversion succeeded 





MBBCCHHR 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 38 of 44 


Extended Description Module Label 


IEAVNPM4 is called by any NIP module to read a member of 
SYS1.PARMLIB. 


1 |IEAVNPM4 receives from the caller the name of the IEAVNPM4 
member of SYS1.PARMLIB to be read. IEAVNPM4 

compares this member name to the name (saved in 

NVTPLNAM) of the last member processed or to zeroes if 

this is the first member. When a new member of 

SYS1.PARMLIB is specified, IEAVNPM4 issues the BLDL 

macro instruction to locate the TTR address of the member. 


e If the BLDL could not locate the specified member 
and the suppress flag, NIPPAFL1, is set to 0, 
IEAVNPM4 issues messge IEA3011 to inform the op- 
erator that it could not find the member. If 
NIPPAFL1 is set to 1, IEAVNPM4 will not issue the 
message. IEAVNPM4 sets a return code of 4 and 
continues with Step 4. 


e If the BLDL macro instruction encounters an I/O 
error, IEAVNPM4 issues message |E A300! to the 
operator. IEAVNPM4 sets a return code of 8 and 
continues with Step 4. 


2 JIEAVNPM4 calls IECPCNVT to convert the actual IECPCNVT 
(TTR) address returned by BLDL to a relative 
(MBBCCHHR) adaress. 


e Ifthe conversion fails, IEAVNPM4 sets a return code IEAVNPM4 
of 20. 


e@ Ifthe conversion is successful, IEAVNPM4 puts the 
converted address into the channel program that will 


read the parmlib member's text records. 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 39 of 44 


Input 


1OB 


| 
IOBUSB4 
lOBUSB5 


lOBUSBS& 
lOBUSB7 


ee 






















NVT 


NVTPLBKL 


NVTPLBFS 


NVTPLDCB 


NVTPLBFE 
EE 
ECB 


NVT 


NVTPLRCD 


Process 


3 Read text records 
of SYS1.PARMLIB 
member into workarea 


e Read succeeded 
but block of records 
is short 


eRead succeeded 
and block of 
records is acceptable 
length 


@Read failed 


4 Return to caller. 


To 
caller 





Output 


NVT 
NVTPLBFE 


NIPPAREA 


NIPPARCD 


Register 1 





Register 1 


| | Lee | 


Address of first 
non-blank character 


Register 15 


NIPPAREA 


NIPPARC 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 40 of 44 


Extended Description Module Label 


3 IEAVNPM4 reads a block of records when a new 
parmlib member has been specified or when the 
buffer for the current member is empty. 


IEAVNPM4 issues the EXCP macro instruction to read 
text records of a parmlib member into a buffer workarea 
it sets up. 


e If the EXCP is successful, but a short block of records 
is read and that block is not a multiple of the logical 
record length of 80, IEAVNPM4 issues message 
IEA334A to inform the oeprator that the record 
length is invalid. IEAVNPM4 then waits for the 
operator’s response. If the operator indicates that 
processing should continue, {EAVNPM4 rounds the 
invalid block size up to a multiple of 80 and adjusts 
the field NVTPLBFE to point to the end of the short 
block. 


e If the EXCP is successful and the block is a multiple 
of the logical record length of 80, IEAVNPM4 moves 
the records from the buffer into the IEAVNPM4 
parameter area and then scans the records for validity. 
When columns 1-71 are blank, but column 72 is non- 
blank, IEAVNPM4 automatically reads or scans a new 
record. !{f the record is valid, JEAVNPM4 sets column 
72 toa blank, column 73 to a null (X'FF’) character,. 
and register 1 to the address of the first non-blank 
character. When columns 1-72 are all blank, register 1 
contains the address of column 72. 


e@ If the EXCP fails, IEAVNPM4 determines what type 
of 1/O error occurred. If the error is end-of-file, 
[IEAVNPM4 sets a return code of 16. Otherwise, 
IEAVNPM4 sets a return code of 12 and issues mes- 
sage [EA306I via the NIPSENSE service to inform 
the operator of the error. 


4 JIEAVNPM4 returns to the caller with a return code in 

field NIPPARC of the IEAVNPM4 parameter area, and 
in register 15. {f the return code is non-zero, IEAVNPM4 
sets register 1 to —1. 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 41 of 44 


TEAVNPM5 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: NIP Console Attention Routine 
FUNCTION: 
This module receives control from IOS when IOS has received 
an attention. This module will post the NCT ECB whenever 
the NIP console issued the attention. Otherwise the attention 
1S ignored. 
ENTRY POINT: IEAVNPM5 
PURPOSE: See function. 
LINKAGE: Call from IOS. 
CALLERS: IOS. 
INPUT: 
Register 1 will contain the address of the IOSB for the 
UCB which issued the attention. 
OUTPUT: NIP ECB posted. 
EXIT NORMAL: Return to caller via register 14. 
OUTPUT: See output above. 
EXTERNAL REFERENCES: 
ROUTINES: None 


CONTROL BLOCKS: 
IOSB pointed to by Register 1. 


IOSB - pointed to by Register l. 
CVT - Communications Vector Table 
NVT - NIP Vector Table 

NCT - NIP Console Table 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 42 of 44 
ITEAVNPMS - MODULE OPERATION 


This module runs in SRB mode and therefore cannot issue any 
SVC‘s. By using the STACK procedure option, the compiler 
generates the entry and exit linkage with the specified 
overrides for the getmain and freemain macro. These macros 
will be locally coded to use the branch entry form of the 
macro. The post macro will also use branch entry. 


Because this routine resides in the IEAVNIPM load module, it 

will run in 24-bit mode. However, IOS issues a BASSM to call 
this routine, so we must return in the mode of the caller by 

specifying AMODE(24,*) in the procedure options. 

. If the attention came from the NIP console: 


- POST the NCT ECB. 
- Set the attention pending switch in the NCT on. 


Otherwise, do nothing. 
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Diagram 10. NIP Control and Service Routine (IEAVNIPM) Part 43 of 44 


ITEAVNPM5 - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAVNPM5 
MESSAGES: None 

ABEND CODES: None 

WAIT STATE CODES: None 
RETURN CODES: None 

REGISTER CONTENTS ON ENTRY: 
0 to 13 - Irrelevant 


14 - Return address 
15 - Entry point address 


REGISTER CONTENTS ON EXIT: Irrelevant 
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Diagram 10. NIP Control and Service Routine TEAVNIPM) Part 44 of 44 


IEAVNPMS = NIP Console Attention Routine STEP 01 


Ios. 
This module receives control from IOS when 
N IOS has received an attention. This module 
>| ]will post the NCT ECB whenever the NIP 
/ console issued the attention. Otherwise 
ITEAVNPMS5| | the attention is ignored. 


Post a NIP ECB in the NCT. 
\| A. Force compiler to generate a value for \ 
Rl / variables used in the entry linkage. ee IOSBPTR 


TEANCT een >| B. Post the ECB \ 


/|GPRI1OF 
NCTECB POST GPR11P 


(NCTECB) BRANCH(YES ) 





C. BRANCH TO SERVICE 
yoy 
\-— 





D. The “RETURN' is required by FREEMAIN's 
use of register 3 in the exit linkage. 
The return code is required by the 
caller. 
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Diagram 11. Service Processor CALL SVC Initialization (IEAVNPE6) Part 1 of 2 


IEAVNIPM 
(Step 2) 


Input 


Register 3 








CVTSCPIN acces 1 Determine whether 


service processor 
hardware is present. 


2 Build service processor 


Reigster 2 control blocks. 


NVTHCSVC 


Control register 0 


[| 


1EAVNIPM 


Output 


VT 


7?) 


CVTMSF CB 


MSF AB 
(service processor 
attention block) 


"MSFCB’ 


MSFCMSFA 
MSFCMSFK 
MSFCADB 


MSFCEP1 


2K buffer 


MSFKB 
(service processor 


communication block) 


MSFKADB 


MSFCB 
(service processor 
control block) 


MSF AADB 


MSF DSDB 


2K buffer 


Recovery buffer 


(8 bytes) 


KO 
A 
z 
o 
5 
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Diagram 11. Service Processor CALL SVC Initialization (IEAVNPES) Part 2 of 2 


Extended Description Module Label 


|IEAVNIPM calls the service processor RIM, IEAVNPEG6, to 
build the control blocks and buffers required by the service 
processor CALL SVC, which MVS users use to communicate 
with the hardware’s service processor. (See System Logic 
Library, for a description of service processor CALL SVC 
processing. ) 


1 IEAVNPEG first checks CVTSCPIN, which is set by NIP, [EAVNPE6 
to determine if service processor hardware is present. If 

service processor hardware is not present, IEAVNPEGE sets the 

pointer to the service processor CALL control blocks (the 

CVTMSECB field) to zero indicating that the service processor 

CALL SVC is not supported, and returns to IEAVNIPM. 


2 __=«=(If service processor hardware is present, IEAVNPE6 
builds the control blocks as follows: 


e Obtains storage for the control blocks and buffers 
shown in the output section of the diagram. Because 
the service processor buffers must be on 2K boundaries, 
{,EAVNPEG6 uses a GETMAIN macro instruction to acquire 
three 4K blocks from SQA and thus force page boundaries. 


@ Chains the control blocks together. 


e Places the service processor CALL SVC branch entry 
point in the MSFCEP'1 field. 


e Places the address of the MSFCB in the CVTMSFCB 
field. 


e Sets bit 22 of control register 0 to ‘1’ to ensure that the 
processor is enabled for service processor interrupts. 
When type 2 extended SVC initialization is complete, the 
service processor CALL SVC can execute successfully. 


e@ Frees the unused part of the 12K of storage obtained at 
entry. 
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Diagram 12. System Recovery Initialization (IEAVNPA6) Part 1 of 3 
IEAVNPA6 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: RTM‘'S early NIP initialization (RIM module) 
FUNCTION: 


This module is the resource initialization module (RIM) that is 
given control during nucleus initialization to allocate and to 
initialize permanent data areas used by tha recovery termination 
manager (RTM). IEAVNPA6 aquires storage for the following data 
areas and initializes them: 


- the R™ control table (RTCT) 

- the RTM quick cell pool 

- the recording buffers control block (RBCB) 
- the recording buffers (RCBs) 


All storage for these data areas is obtained from the system queue 
area (SQA), subpools 239 and 245. 


ENTRY POINT: IEAVNPA6 
PURPOSE: See function 
LINKAGE: Load and BALR 
CALLERS: IEAVNIPM 
INPUT: 
NIP Vector Table (NVT) 
Communications Vector Table (CVT) 
OUTPUT: Initialized control blocks 
EXIT NORMAL: Returns to the caller 
EXTERNAL REFERENCES: 
ROUTINES: 
GETMAIN - Allocate storage service 
CPOOL - Build a cell pool for EEDs and SRBs 


CONTROL BLOCKS: 


Common name macro id usage function 

CVT CVT read, Establishes addressability 
write to the RTCT. 

PSA IHAPSA read Establishes addressability 

to the CVT. 

RBCB RTMRBCB create, Recording buffers control 
read, block 
write 

RCB RTMRCB create, Contains recording request 
write entries. 

RTCT IHARTCT create, Recovery termination control 
write table 

SRB IHASRB create Service request block 
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Diagram 12. System Recovery Initialization (IEAVNPA6) Part 2 of 3 
TEAVNPA6 - MODULE OPERATION 


IEAVNPA6 receives control during nucleus initialization to allocate 
and to initialize the major control blocks used by RTM. IEAVNPA6 
receives control from IEAVNIPM and performs the following 
processing: 


LY28-1200-4 © Copyright IBM Corp. 1982, 1987 


Obtains storage for the RTCT from subpool 245 (below the 16M 
line). Clears the RTCT to zero and inserts the control block 
id. SDUiPs are inhibited by setting the appropriate SVC dump 
option flag in the RTCT, and use of SDUMP 4K buffer (which has 
not yet been acquired) is inhibited by indicating, in the CVT, 
that the buffer is in use. 


Builds a cell pool for the EEDs and SRBs in subpool 239 (below 
the 16M line) (via the CPOOL macro). 


Obtains storage for the RBCB from subpool 239 (above the 16M 
line). Initializes the RBCB. 


Obtains storage for the RCBs from subpool 239 (above the 16M 
line). Initializes the RCBs. 


Section 5. Method of Operation 
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Diagram 12. System Recovery Initialization (IEAVNPA6) Part 3 of 3 
IEAVNPA6 - DIAGNOSTIC AIDS 

ENTRY POINT NAME: IEAVNPAG 

MESSAGES: None 

ABEND CODES: None 

WAIT STATE CODES: None 


RETURN CODES: 
EXIT NORMAL : 


0 in register 15 


REGISTER CONTENTS ON ENTRY: 


Registers O-1 - Irrelevant 

Register 2 - Address of the NIP vector table (NVT) 
Register 3 - Address of the CVT 

Registers 4-12 - Irrelevant 

Register 13 - Address of a 72 byte register save area 
Register 14 - Return address 

Register 15 - Entry Point address 


REGISTER CONTENTS ON EXIT: Irrelevant 
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Diagram 13. Machine Check Handler Initialization (IEAVNP06) Part 1 of 4 


Input 





IEAVNIPM 
(Step 4) 


Process 






1 Obtain storage for a 
spare LOGREC record 
block (LRB). 


e If machine check 
extended logout 
area (MCEL) 
exists, obtain 
storage for it. 


CVTSCPIN SCPINFO 


information block 2 Obtain storage for 
oe 


message buffer pool. 
SCPNCPS 


|IGFPEMER module 3 Obtain storage for 


IGFEMER work area. 
|IGFEMERL 


a ee 
RVTLRBPT 


RV TMSGPT 


IGFPEMER work area 
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Diagram 13. Machine Check Handler Initialization (IEAVNP06) Part 2 of 4 


Extended Description 


IEAVNIPM calls the machine check handler (MCH) RIM, 
IEAVNPO6, to initialize the machine check handler control 
blocks for the IPL processor. [EAVNPOO will perform this 
task for the non-|PL processor. 


1. qTheMCH RIM issues a GETMAIN macro instruction to 

obtain storage from subpool 239 for the spare LOGREC 
record block (LRB) and the machine check extended logout 
area (MCEL) which immediately follows the LRB, if there 
isa MCEL. The MCH RIM sets RVTLRBPT to the start 
address of the LRB. The spare LRB is used by IGFPMRTM 
during normal machine check processing. 


If the GETMAIN macro instruction returns a non-zero return 
code, the MCH RIM uses the NIP macro IEAPMNIP 
TYPE=SWAIT to issue a wait state code of X‘OE8’ with a 
reason code of 83rr, where rr is the return code from the 
GETMAIN macro instruction. 


2 The MCH RIM issues a GETMAIN macro instruction 
to obtain storage from subpool 239 for the message 
buffer pool. There are 8 message buffers for each processor 
in the system. SCPNCPS gives the number of processors 
in this system. The last message buffer is marked in use so 
that alternate CPU recovery (ACR) routine IEAVTACR, is 
certain to have a buffer for the “ACR COMPLETE’ message, 
IEA8581. 


\f the GETMAIN macro returns a non-zero return code, the 
MCH RIM issues a wait state code of X‘OE8’ with a reason 
code of 83rr, where rr is the return code from the GETMAIN 
macro Instruction. 


Module Label 

IEAVNPO6 IEAVNPO6 
ABEND 
IEAVNPO6 
ABEND 


Extended Description 


3 The MCH RIM issues a GETMAIN macro instruction to 

obtain storage from subpool 239 for the work area that 
will be used by [|GFPEMER during abnormal system term- 
mination. |GFEMERL is an external field located in 
|GFPEMER; it contains the size of the automatic data area 
for 1GFPEMER during abnormal system termination. The 
MCH RIM initializes RWAEMERA with the start address of 
the workarea., 


If the GETMAIN macro returns a non-zero return code, the 
MCH RIM issues a wait state code of X’0E8’ with a reason 
code of 83rr, where rr is the return code from the GETMAIN 
macro instruction. 


Module 


Label 


IEAVNPO6 


ABEND 
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Diagram 13. Machine Check Handler Initialization (IEAVNPO6) Part 3 of 4 


Process Output 








Control register 14 Control register 15 










4 Obtain storage for and 
initialize control blocks 
,or the IPL processor 
and initialize its contro! 

registers 14 and 15. 

















IGFPBUCR 


MCH contro] 
block 
initialization 








PCCALRBV 


PCCAPWAV 


PWAENV 


PWATRACV 
——— 


MCH path 
trace area 











RVT 
RVTRWAPT 





elf IGFPBUCR fails, 
then place the IPL 
processor in wait state. 











ee 
RWAINIT 
— 


elif |GFPBUCR succeeds, 
indicate in RWA that 
MCH initialization is 
complete. 












5 Return to lEAVNIPM. 


IEAVNIPM 


u c 
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Diagram 13. Machine Check Handler Initialization (IEAVNP06) Part 4 of 4 


Extended Description 


4 The MCH RIM calls |GFPBUCR to initialize control 

registers 14 and 15 and the following CPU-related 
control blocks: the LRB, PWA, ENV, and MCH path trace 
area. 


e If IGFPBUCR was not successful, the MCH RIM places 
the IPL processor into a wait state with a code of X‘0E8’. 
Bytes 4 through 7 of the loaded PSW will be in the form 
*xxrrQOE8’ where xx is the reason code and rr is the return 
code. 


Return Code Meaning 
81 IGFPBUCR returned a non-zero return 
code (rr) when it was called to allocate 
the MCH control blocks. 
82 IGFPBUCR returned a non-zero return 
code (rr) when it was called to initialize 
the control registers. 


e if IGFPBUCR was successful, the MCH RIM indicates that 
MCH initialization is complete for the IPL processor by 
setting the bit RWAINIT to 1. 


For more information on |GFPBUCR, see System Logic 
Library. 


5 The MCH RIM returns to IEAVNIPM via the BSM 
instruction. 


Module Label 


IGFPBUCR 


IEAVNPO6 ABEND 


. IEAVNPO6 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 1 of 20 
IEAVNP27 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: Reconfiguration Installed Resources RIM. 
FUNCTION: 
Obtain and initialize the Installation Channel Path 
Table (ICHPT) and the Configuration Management Table (CMT). 
ENTRY POINT: IEAVNP27. 
PURPOSE: See FUNCTION. 
LINKAGE: CALL IEAVNP27. 
CALLERS: IEAVNIPM - NIP Control/Service Routines. 
INPUT: See entry registers. 
OUTPUT: None 
EXIT NORMAL: Return to caller. 
OUTPUT: 

1. CVTICHPT points to the ICHPT. 

2. The ICHPT is initialized. 

3. CSDCMT points to the CMT. 

4. The CMT is initialized. 
EXIT ERROR: Disabled wait state. 

OUTPUT: See Wait State Codes for diagnostic data. 

EXTERNAL REFERENCES: 
ROUTINES: IEEVORGI - Obtain Resource Group Information. 


CONTROL BLOCKS: 
Common name/use Macro name Description 


BITMAPCB PCR D IEEMBITM Resource Bit Map Arrays 


CHPI PCR D IEEMCHPI Read Channel Path Information 
Command Information 

CMT PCRM IEEMCMT Configuration Management Table 

CSD M ITHACSD Common System Data Area 

CVT RM CVT Communication Vector Table 

ICHPT CM IHAICHPT Installation Channel Path Table 

NVT RM IHANVT NIP Vector Table 


ORGIPARM PCRMD IEEMORGI Obtain Resource Group 
Information Parameter List 


SCCB CRMD IHASCCB Service Call Control Block 
SCCBSCPI R IHASCCB SCP Information 
SPCS PCRMD IEEMSPCS Service Processor Call 


Parameter list 


C=created, R=referenced, M=modified, D=deleted, 
P=private to the reconfiguration component 
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Diagram 14. Reconfiguration Installed Kesources RIM (IEAVNP27) Part 2 of 20 
IEAVNP27 - MODULE OPERATION 

Obtain channel path information from the service processor 

command: Read Channel Path Information. 

If the service processor architecture is supported, 

obtain side information for each side from 

the Obtain Resource Group Information routine (IEEVORGI}). 

If an MSSF is installed, 

obtain I/0 side information by issuing the MSSF command: 


I/O Side Information. 


Cbtain and initialize the Configuration Management Table (CMT) 
with side, real storage slement, and channel path information. 


Obtain and initialize the Installation Channel Path Table 
Table (ICHPT) with the channel path information. 


Initialize pointers to the CMT and the ICHPT. 


RECOVERY OPERATION: None, since IEAVNP27 executes before RIM is initialized. 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 3 of 20 
IEAVNP27 ~- DIAGNOSTIC AIDS 

ENTRY POINT NAME: IEAVNP27. 

MESSAGES: None 


ABEND CODES: None 


WAIT STATE CODES: 


X'xxxxxO2Z0 ' 


*'00010020' - IEAVNP27 failed to obtain channel path 
information. 
Diagnostic information is stored in 
IEAVNP27 diagnostic save area pointed to by 
CSDCMT. 
Offset O - Failure type descriptor: attempt to use SVC 122 
Extended SVC Routing Code 6», 'SPCS’ = X'E2D7C3E2'. 
Offset 4% - Return code from SVC 122 ESR 6. 
Offset 8 - Address of the NVT. 
Offset 12 - Address of the CVT. 
Offset 16 - Unpredictable. 
Offset 18 - Service processor response code. 
Offset 20 - Service call command word. 
Offset 24 - Address of the SCCB. 
Offset 28 - Unpredictable. 
Offset 40 - Data register. 
Offset 44 ~ First code register. 
Offset 48 - Second code register. 
Offset 52 - Address of standard save area. 
Offset 56 - Return address. 
Offset 60 - Address of entry point. 
X'00020020' - IEAVNP27 failed to obtain I/O side 
information. 
Diagnostic information is stored in 
IEAVNP27 diagnostic save area pointed to by 
CSDCMT. 
Offset 0 - Failure type descriptor: attempt to use SVC 122 
Extended SVC Routing Code 6, 'SPCS' = X'E2D7C3E2'. 
Offset 4% - Return code from SVC 122 ESR 6. 
Offset 8 - Address of the NVT. 
Offset 12 - Address of the CVT. 
Offset 16 - Unpredictable. 
Offset 18 - Service processor response code. 
Offset 20 - Service call command word. 
Offset 24 - Address of the SCCB. 
Offset 28 - Unpredictable. 
Offset 40 - Data register. 
Offset 44 - First code register. 
Offset 48 - Second code register. 
Offset 52 - Address of standard save area. 
Offset 56 - Return address. 
Offset 60 - Address of entry point. 
X'00030020' - IEAVNP27 failed to obtain side 
information. 
Diagnostic information is stored in 
IEAVNP27 diagnostic save area pointed to by 
CSDCMT. 
Offset O - Failure type descriptor: call IEEVORGI, 
"ORGI' = X'DEDIC7TCI' 
Offset % - Return code from IEEVORGI. 
Offset 8 ~- Address of the NVT. 
Offset 12 - Address of the CVT. 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 4 of 20 
IEAVNP27 - DIAGNOSTIC AIDS 


(Continued ) 


Offset 16 - Unpredictable. 
Offset 40 - Data register. 
Offset 44 - First code register. 
Offset 48 - Second code register. 
Offset 52 - Address of standard save area. 
Offset 56 - Return address. 
Offset 60 - Address of entry point. 
X'00040020' - IEAVNP27 failed to obtain 
the length of the side information block. 
Offset O - Failure type descriptor: call IEEVORGI, 
"ORGI' = X'D6éD9C7C9' 
Offset 4% - Return code from IEEVORGI. 
Offset 8 - Address of the NVT. 
Offset 12 - Address of the CVT. 
Offset 16 - Unpredictable. 
Offset 40 - Data register. 
Offset 44 - First code register. 
Offset 48 - Second code register. 
Offset 52 - Address of standard save area. 
Offset 56 - Return address. 
Offset 60 - Address of entry point. 


RETURN CODES: 


None 


REGISTER CONTENTS ON ENTRY: 


GPRO-1: Unpredictable 

GPR2: Address of NVT 

GPR3: Address of CVT 

GPR4-12: Unpredictable 

GPR13: Address of standard save area 
GPR14: Return address 

GPRI5: Address of entry point 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 

GPRO-15: Unchanged 
EXIT ERROR: 


GPRO-15: Unpredictable 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 5 of 20 
IEAVNP27 - Reconfiguration Installed Resources RIM. STEP 01 


IEAVNIPM - NIP Control/Service 
Routines. Obtain and initialize the Installation 
N Channel Path Table (ICHPT) and the 
>| | Configuration Management Table (CMT). 


/ 
IEAVNP27 


Obtain channel path 
information. 


sy 
\-—7 CHPINFO: 13 


If the service processor 


architecture 1s supported, 
obtain side information for 
all sides. 


CVT Ui ena > a, 


Vo SIDEINFO: 19 
CVTSVPRC 


03 If an MSSF is installed, 
obtain I/0 side information 
for all I/0 sides. 


a 
\r-—/ IOSIDINF: 24 


Obtain and initialize the 
CNT header and the 
configuration data in the 
CMT. 


sy 
\r-—7 INITCMT: 29 


05, Initialize the side data in 
the CMT. 


vy 
\r—/ INITSIDE: 35 


06 | If side information was 
obtained and included 
storage element data, 
initialize the real storage 
element data in the CMT. 





5-142 MVS/XA System Init Logic LY28-1200-4 © Copyright IBM Corp. 1982, 1987 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 6 of 20 


IEAVNP27 =- Reconfiguration Installed Resources RIM. STEP 07 
CVT f--~------- > sA1N 

; vf anerees 
3 


CMTSE, NUMRSE, NUMRSE-1 





SCCB 
Initialize channel path data 


SCCBRRGI 
in the CMT. 


ss 
\r-—7 INITCHP: 46 


Initialize channel path data 
in the ICHPT. 


/L 
\r7Z INITICHP: 53 


IEEMCMT pe > Initialize the pointer to \CSD 
the CMT in the CSD. / 

ICHPT port > Initialize the pointer to \CVT 
the ICHPT in the CVT. / 


Free the temporary storage 
blocks. 


- - - 
nN -_= So 


Return to the module caller. 


4 | 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 7 of 20 


IEAVNP27 - Reconfiguration Installed Resources RIM. 


13 > Obtain channel path 
/ information. 
CHPINFO 


[14 Get storage for a service 
call control block (SCCB). 


seo 
\cc2 QSTG: 58 
LENGTH(SCCB ) 


Obtain channel path 


information from the service 
processor. 






i 


\o—/ SRVPROC: 66 





SPCSCHPI 


If channel path information 
was obtained, set the 
channel path information 
pointer to the channel path 
information returned by the 
service processor. 


If channel path information 
could not be obtained, 
terminate system 
initialization with a 
disabled wait state code 
X'900010020'. 


soy 


\ce—17 TERMINAT: 71 


WAIT_CHPINFO, SVC122, 


SRVPROC_RC, SCCBRSP » 
SPCSCHPI, LINKDATA 


Return to the subroutine 


caller. 








STEP 13 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 8 of 20 
IEAVNP27 =- Reconfiguration Installed Resources RIM. STEP 19 


\ 
19 > 
/ 
SIDEINFO 


SCCB 


SCCBRRGI 


IEEMORGI i > 


ORGRCNID 


IEEMORGI 5 en > 


ORGRCOK 


IEEMORGI po > 


ORGRCNID 





Obtain the side information 
for each installed side. 


If the service processor 
command, Read Resource Group 
Information, is installed, 
obtain the length of the 
storage needed for the side 
information block. 


If the length of the side 
information was obtained, 
obtain the side information 
for each installed side. 


. Get storage for the side information. 


QSTG: 58 


soy 





SIDE_INFO_LEN 


. Get the side information. 


. If the side information was obtained, 


increment the side counter and the real 
storage element counter. If this is the 
first side information block, set the 
side information pointer to this first 
side information block. 


sy 


\r—/ COUNTRSE: 76 


. If the requested side ID is not 
installed, stop requesting for 
information. 


. If side information could not be 


obtained, terminate system 
initialization with a disabled wait code 
*'00030020'. 


TERMINAT: 71 


WAIT_SIDEINFO, ORGINAME , 
ORGIRC, NOTUSED, NOTUSED, 
NOTUSED 


sy 


- Set the side counter to the number of 


sides installed. 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 9 of 20 
IEAVNP27 = Reconfiguration Installed Resources RIM. STEP 22 


If the length of the side 
information block could not 
be obtained, terminate 
system initialization with a 
disabled wait code 
X'00040020'. 


s_Ay 


TERMINAT: 71 


WAIT_SIDELEN, ORGINAME ; 
ORGIRC, NOTUSED, NOTUSED, 
NOTUSED 


Return to the subroutine 
caller. 





Obtain I/70 side information \SPCS 
for each installed I/0 side. / 
CSD prcccoo---- > [25 Obtain the I/70 side 
= information for each 
, installed 1/0 side. 
SCCB A. Get storage for a service processor call 


control block (SCCB). 


SCCBRCC 
sv 


—! 
SPCSRINF LENGTH{(SCCB ) 


B. Obtain the I/O side information for the \SPCS 
target I/0 side. / 





SPCSSCP 


aN 


\—/ SRVPROC: 66 





SPCSSCMD 


C. If the I/0 side information was obtained 
and this is the first I/O side 
information block, set the first side 
information pointer to this first I/O 
side information block. 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 10 of 20 


IEAVNP27 - Reconfiguration Installed Resources RIM. STEP 25D 
SCCB eieatestestedeateieataatn >| D. Set the non IPL I/O side information 
-3 pointer to this I/O side information 
: block, if any of the following 
: conditions is true: the I/O side 
SPCS : information was obtained, the I/O side 
— is offline and unassigned, the I/O side 
is assigned to another partition, the 


I/O sid2 1s in service, maintenance or 
repair state. 


SCCB | a ainaataetedaated >| E. Set the IPL I/O side information pointer 
to this I/0 side information block if 
SCCBCMDD all of the following conditions are 


true: the I/O side information was 
obtained, the I/O side is online, the 
I/O side is assigned to this partition, 
the I/O side is not in service, 
maintenance or repair state. 


F. Terminate system initialization with a 
disabled wait state code X'00020020' if 
all of the following conditions are 
true: the I/O side information can not 
be obtained, obtain I/O side information 
is a valid MSSF command, the I/O side ID 
is valid, the I/O side is installed. 


SCCB helen ieninieeateneienie! > sn 


-: \r—7/ TERMINAT: 71 
SCCBRSP : 


WAIT_IOSIDEINFO, SVC12z, 





SPCS : SRVPROC_RC, SCCBRSP, 
— SPCSSCMD, LINKDATA 
SPCSINVL SPCSINVC 


CHPI | ---------- > If there is an I/0 side that 


is not assigned to the IPL 

configuration, indicate that 
all the installed channel 
paths that dco not belong toa 
the IPL I70 side belong to 
the non IPL I/0 side. 


Set the side counter to the 
number of I/0 sides 
installed. 


Return to the subroutine 


caller. 


u 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 11 of 20 


IEAVNP27 - Reconfiguration Installed Resources RIM. STEP 29 
\ 
29 > Obtain and initialize the 
/ CHT header and the 


INITCMT 


/ 
CMTIDV CMTVRSNV 


A. If at least two sides are installed, 


configuration data. 





Get storage for the CMT. 


Clear the storage obtained 
for the CMT. 


Initialize the CMT header. \IEEMCMT 
/ 
CMTID 


CMTVRSN 
Initialize the configuration 
data in the CMT. 


\IEEMCMT 


the configuration has one side 


installed. 


\ 
35 > 
/ 
INITSIDE 


indicate the configuration has multiple / 
sides installed in the CMT. 
B. If no sides are installed, indicate that 
Return to the subroutine 
\ 7 


caller. 


Initialize the side data in 
the CMT. 


Initialize the side entry in 
the CMT. 


sey 


\-/ INITRES: 42 


IEEMCMT 2 —s pw e=------- > 
| \ 
CMTSIDE CMTR / 






ITEEMCMT 
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CMTSIDE, NUMSIDE, NUMSIDE-1 


Obtain storage for a 
resource array to describe 
sides. 


Clear the storage obtained 
for the resource array. 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 12 of 20 


IEAVNP27 = Reconfiguration Installed Resources RIM. STEP 39 














the type, the ID and set the / 
valid indicator in the 


resource array. 


Initialize the pointer to 


the resource array for sides 
in the CMT. 


TEEMCMT \ 
/ 
CMTMAX CMTSIDE 


IEEMNCMT po > 


CMTSIDE 


/ 


[43] Return to the subroutine 
caller. 


Initialize the entry for a 
given resource type in the 


PARAMETERS CMT. 
RESTYPE RESCOUNT 
RESMAX 
PARAMETERS \ [43] Initialize the eye-catcher, 















RESTYPE 


IEEMCMT 


RESCOUNT 


IEEMCMT a > 






=: \ installed, initialize its 
; / maximum installed ID and 
: indicate that the maximum 
PARAMETERS ; installed ID is valid in the 
—d CMT. 
PARAMETERS [45] Return to the subroutine 


caller. 
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For each side, initialize \IEEMCMT 





\IEEMCMT 


CMTVCMTR 
CMTCHTR 


\ITEEMCMT 


\ 7 
the resource type, the / 
resource installed count, 
and indicate the installed 
count is valid in the CMT. 
[44 If this resource type is \IEEMNCMT 
\ 7 





/ 
CMT VMAX 
CMTMAX 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 13 of 20 
IEAVNP27 - Reconfiguration Installed Resources RIM. STEP 46 


Initialize the channel path 
data in the CNT. 


ICHPT t ---------- > Count the number of channel 
paths installed. 


A. Check the installed indicator in the 


channel path information for a channel 
path. 


B. If the channel path is installed, update 
the count of installed channel paths, 
and update the highest installed channel 
path IO. 


Initialize the channel path 
type, the installed count, 
and the maximum installed ID 
in the CMT. 


sv 


\r— 7 INITRES: 42 


CMTCHP, NUMCHP, HIGHEST_CHP 


ITEEMCMT pc > If there 1s at least one 
channel path installed; 

obtain a resource array to 

describe the channel paths. 


CMTNUM CMTCHP 


TEEMCMT Py >| A. Obtain storage for a resource array for 
\ channel paths. 







CMTCHP CMTR 


TEEMCMT 


. Clear the storage obtained for the 
resource array. 


ICHPT a > For each installed channel 


path, initialize the channel 
path type, the ID,» and the 

address of the resource 

array that describe the side 


which owns the channel path 
in the resource array. 


. If the channel path is installed, 
initialize the channel path type and ID 
in the resource array. 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 14 of 20 
IEAVNP27 =- Reconfiguration Installed Resources RIM. STEP 508 


TEST(CHPID) INARRAY(CHPIINST) RESULT 
BITVALUE( INSTFLAG ) 
ITEEMCMT \ \IEEMCMT 
/ / 
CMTCHP B. If the channel path is owned, initialize 
the owner address in the resource array. 








sey 


ae 
IEEMCMT ry > \LEEMCMT 


\ / 
CMTRSIDE 
IEEMCMT 
IEEMCMT pc > [53] Initialize the pointer to \IEEMCMT 
\ 7 






Ei 


the resource array for / 
channel paths in the CHT. CMTVCMTR 
CMTCMTR 
[52] Return to the subroutine 
caller. 


\ 
53 > Initialize the channel path 
= data in the installation 
INITICHP channel path table (ICHPT). 


Get storage for the ICHPT. 


Clear the storage obtained 
for the ICHPT. 


ICHPT pc > For each channel path, set 


the ICHPT configured, owned, 
and online indicators. 


A. Check the channel path information from 
the service processor to determine if 
the channel path is installed. 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 15 of 20 
IEAVNP27 = Reconfiguration Installed Resources RIM. STEP 568 


BIT 


TEST(CHPID) INARRAY(CHPIINST) RESULT 
BITVALUECINSTFLAG } 





B. If an MSSF is installed, check the 
channel path information from the MSSF 
to determine if the channel path is 
owned. 


C. Check the channel path information from 


the service processor to determine if 
the channel path is physically online. 


BIT 


TEST(CHPID) INARRAY(CHPIAVAL) RESULT 
BITVALUE( OWNFLAG ) 








D. if the channel path is online, set the \ICHPT 
ICHPT configured, owned and online / 
indicators for this channel path. ICHCONFG 
ICHOWNE D 
ICHONLIN 
CVT prcocccces- >| E. Set the ICHPT configured and owned \ICHPT 
“3 indicators for this channel path if all / 
: of the following conditions are true: ICHCONFG 
: the machine supports the service ICHOWNED 
ITEEMCHT : processor architecture; the machine does 


aa not have multiple sides installed, the 
channel path is installed, the channel 


path is not online. 


© 


VT prc-ccccco- >| F. Set the ICHPT configured indicator for ICHPT 


\ 
: this channel path if all of the / 
CVTSVPRC : following conditions are true: the 
: machine supports the service processor 
IEEMCMT : architecture, the machine has multiple 
4 sides installed, the channel path is 
CMTMSIDE installed, the channel path is not 


online. 


G. Set the ICHPT owned indicator for this 
channel path if all of the following 
conditions are true: the machine 
supports the service processor 
architecture, the machine has multiple 
sides installed, the channel path is 
installed, the channel path is not 
online, at least one channel path is 
online in the side that owns this 
channel path. 


Ji—etN 
\r—7 FINOSIDE: 79 


ICHPT S uceaamccan > \ICHPT 


/ 
ICHARRAY ICHOWNED 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 16 of 20 





ITEAVNP27 =- Reconfiguration Installed Resources RIM. STEP 56H 
CVT Sn >| H. Set the ICHPT configured indicator for \ICHPT 





this chamnel path if all of the 
following conditions are true: an MSSF 
is installed, the channel path is 
installed, the channel path is not 
online. 









/ 
CVTSVPRC ICHCONFG 


I. Set the ICHPT owned indicator for this ICHPT 


\ 
channel path if all of the following / 
conditions are true: an MSSF is 
installed, the channel path is 
installed, the channel path is not 
online, the channel path 1s owned. 


Return to the subroutine 
caller. 


Get a storage storage 
descriptor queue element and 


PARAMETERS its data block. Link the 
queue element to the storage 
STORAGE_LENGTH descriptor queue. 


If the storage descriptor 
queue 1S empty, get storage 
for the first queue element. 
Set the first element 
pointer to this first 
Storage descriptor queue 
element. 


If the storage descriptor 
queue is not empty, get 
Storage for the next queue 
element and link it to the 
end of the storage 
descriptor queue. 


Clear the storage obtained 
for the storage descriptor 
queue element. 


Get the storage for the data 
block and initialize the 
pointer to the data block in 
the storage descriptor queue 
element. 


Clear the storage obtained 
for the data block. 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 17 of 20 
IEAVNP27 - Reconfiguration Installed Resources RIM. STEP 64 









Initialize the length of the 
data block in the storage 
descriptor queue element. 











Return to the subroutine 
caller. 


Call the service processor 
to obtain configuration 
PARAMETERS information. 





SRVPROC_COMMAND 


SPCS f---------- > Call the service processor 
-: to obtain configuration 
SPCSRCBY SPCSRCIU| : information. Retry if the 
SPCSMALF service processor 1s husy, 
: the interface control block 
SCCB : is in use, or an equipment 





= check is indicated. 
SCCBRSP 





SCCB f---------- > If the configuration 
-: information could not be 

: obtained, set the subroutine 
: return code to 4. 

SPCS 


J 
If the configuration 
information was obtained, 
set the the subroutine 
return code to 0. 


Return to the subroutine 
caller. 





5-154 MVS/XA System Init Logic LY28-1200-4 © Copyright IBM Corp. 1982, 1987 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 18 of 20 










IEAVNP27 =- Reconfiguration Installed Resources RIM. STEP 71 
\ 
71 > Store register contents in 
/ IEAVNP27 diagnostic save 
PARAMETERS TERMINAT area and terminate system 
oY initialization with a given 





NP27WAIT TERMRO / disabled wait state. 
TERMR1L TERMRG 


TERMR5 TERMR6 





PARAMETERS Put additional diagnostic 


information into registers. 


N 7 
~ 
nN 










TERMRO TERMRI1 
TERMR4  TERMRS 
TERMR6 Store the registers into the 


IEAVNP27 diagnostic save 


J 
EI 






area. 
741 Set a pointer to IEAVNP27 \CSD 
diagnostic save area in the / 
PARAMETERS \ Load the requested disabled \NVT 
/ Wait state PSW with / 
NP27HAIT X'*xxxxx020'. 
se—\ 
\r—12 


TYPE=SWAIT 


Update the real storage 
element counter by the 


humber of real storage 
elements belonging to a 
given side. 





ITEEMBITM ry > Check each bit map 
\ descriptor. If the bit map 
/ descriptor for real storage 


element is found, increment 
the real storage element 
counter by the number of 
real storage elements 
belonging to this side. 






TEEMBITM 


BITMDCNT BITMMCNT 


Return to the subroutine 
caller. 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 19 of 20 















IEAVNP27 - Reconfiguration Installed Resources RIM. STEP 79 
\ - - 
79 > Find the side which owns a 
/ given channel path. 
FINDSIDE 
IEEMCMT ay > Loop through each installed 
\ Side to find the side that 
/ owns the channel path. 


IEEMCMT 


© 


VT  eateateatatenteentetenta >| A. If the service processor architecture 1s 

\ supported and multiple sides are 

/ installed, scan the installed channel 
path bit map returned by IEEVORGI to 
determine if the side owns the channel 
path. 


CVTSVPRC 


CMTMSIDE 


IEEMBITM 


| 
mi 
im 
= 
© 
= 
4 


BIT 


_J 
BITMMTYP BITMTCHP 


IEEMBITM 


TEST(CHPID) INARRAY(BITMCHIN) RESULT 
BITVALUE( OWNER_ FOUND } 





BITMDCNT B. When an MSSF is installed and multiple 
I/O sides are installed, scan the I/0 
side information to determine if the 


side owns the channel path. 


BIT 


TEST(CHPID) INARRAY(CHPIINST) RESULT 
BITVALUE( OWNER_FOUND ) 





C. If the selected side owns the channel 
path, set the owner ID to the ID of the 
selacted side. 


D. If the selected side does not own the 
channel path, check the next side. 


Ea Return to the subroutine 
caller. 
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Diagram 14. Reconfiguration Installed Resources RIM (IEAVNP27) Part 20 of 20 


—CHPINFO Obtain chamel path information. 


/ 





QSTG Get a storage storage descriptor queue element and its data block. 





SRVPROC Call the service processor to obtain configuration information. 


TERMINAT Store register contents in IEAVNP27 diagnostic save area and terminate system, 








IEAPMNIP 
—SIDEINFO Obtain the side information for each installed side. 
———QSTG Get a storage storage descriptor queue element and its data block. 
| COUNTRSE Update the real storage element co.mter by the number of real storage elements. 
TERMINAT Store register contents in IEAVNP27 diagnostic save area and terminate system. 
IEAPMNIP 
~TORTDINE Obtain I/0 side information for each installed I/O side. 
ere Get a storage storage descriptor queue element and its data block. 
_ Call the service processor to obtain configuration information. 
| epnrnat Store register contents in IEAVNP27 diagnostic save area and terminate system. 
ITEAPMNIP 


pINTTCMT Obtain and initialize the CMT header and the configuration data. 
| _surrst0e Initialize the side data in the CMT. 

INITRES Initialize the entry for a given resource type in the CMT. 
“——-INITRES Initialize the entry for a given resource type in the CMT. 


~—INITCHP Initialize the channel path data in the CHT. 





INITRES Initialize the entry for a given resource type in the CMT. 
FINDSIDE Find the side which owns a given channel path. 
INITICHP Initialize the channel path data in the installation channel path table (ICHPT). 


FINDSIDE Find the side which owns a given channel path. 
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Diagram 15. Non-Direct Access Device Initialization (IEAVNPA2) Part 1 of 4 


IEAVNIPM 
(Step 5) 


oo] wuy warskg VX/SAW QCI-C 


L961 ‘7861 “49D Wa] Wyahdop © b-00Z1-8ZAT 





Process 


1 Initialize subchannels. 


2 Test the availability of all non-direct 
access storage devices 


Output 


SCHIP SCHE 
(Interrupt (Enabled for 
Parameters) | interrupt flag) 


SCHLM 
(Address limit 
mode flag) 





IOSVNPTH 


Determine 


logical paths 





Wa] go Apradoig — syeiiazBjAl pesuzoiy 


INET $0 SfEFE A] P2294 S3y,,, 


L861 ‘7861 “dod WAI WsUAdCD © fF-007Z1-87AT 


vorjesadgO Jo poyyap “¢ UOTDaS 


6S1-S 
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Diagram 15. Non-Direct Access Device Initialization (IEAVNPA2) Part 2 of 4 


Extended Description Module 


IEAVNIPM calls the input/output supervisor (IOS) RIM, 
IEAVNPAZ, to initialize all subchannels, build the installed 
channel] path table (ICHPT), and test the availability of all 
devices that are not direct access devices. It also initializes 
their unit control blocks (UCBs). When IEAVNPA2 finishes 
processing, NIP will be able to issue the message SPECIFY 
SYSTEM PARAMETERS to the operator. 


There is a UCB for each device attached to the system. It 
describes the characteristics of the device to the |/O super- 
visor and the job scheduler. Entries in the device class queue 
(DCQ) point to the UCBs; thus, components can locate the 
UCBs for all devices in a device class without having to scan 
through the entire UCB chain. 


1 To initialize subchannels, the |OS RIM performs the 

following steps for all subchannels, beginning with 
subchannel number 0 and ending when the RIM has 
tested all subchannels: 


IEAVNPO2 


@ issues a store subchannel (STSCH) command. The 
output of the store subchannel command is the 
hardware subchannel information block (SCH!B), 
which includes the path mask control word (PMCW), 


® Issues the |OSLOOK macro instruction to find the 
address of the UCB associated with the subchannel. 


— If [OSLOOK does not return the address of a UCB, 
the 1OS RIM leaves the subchannel disabled. 


— If l|OSLOOK returns the address of a UCB, the 
IOS RIM initializes the UCB and the |OS SCHIB 
for the subchannel to the following values: 


Extended Description 


Field initialized 


UCBCHPID 
UCBENABL 
UCBISC 


UCBLPM 
UCBNOCON 
UCBPIM 
UCBSID 
SCHIP 
SCHLM 
SCHFLG1 


SCHE 


Module Label 


Initialization value 


*B’ — Channel path IDs 

‘1’ — allowing interrupts to occur 
‘5’ — indicating priority within a 
range of 0 to 7 with O being high 
logical path mask 

‘0’ — indicating UCB connected 
path installed mask 

subchannel number 

UCB address 

’0’ — address limit mode 

’5’ — indicating priority within a 
range of 0 to 7 with O being high 
‘1’ — indicating the subchannel 
is enabled 


Issues a modify subchannel command to enable the sub- 
channel and update the hardware SCHIB with the values 
in the 1OS SCHIB. 


Wag] jo Ayadoig — syeliayeyA] posuasry 
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Diagram 15. Non-Direct Access Device Initialization (IEAVNPA2) Part 3 of 4 


Input Process 


CVTUCBA 


CVTDCQA 
EE 


_——————————— 
DCOFIRST UCBNXUCB 


UCB3DACC=0 


. DCQCHAIN 


DCQOBEVCL 

(Non - DASD) 'UCBNXUCB 

yy» 3 Test the availability 
of non-direct access 
devices 


wnt iancs UCB3DACC=1 


DCQCHAIN 


DCQDEVCL : 
(DASD) UCBNXUCB 


DCQVCBAD | UCB3DACC=0 


UCBNX 
DCOCHAIN ne 


: UCB3DACC=0 
DCQDEVCL | 
(Non-DASD}; 


DCQVCBAD 


IEAVNIPM 





Output 











UCBSID (Subchannel ID number) 


UCBPIM (Path installed mask) 


UCBISC (Logical interruption subclass) 


UCBCHPID (Channel path ID) 


UCBLPM (Logical path mask) 





UCBVHRSN | UCBVORSN | UCBONLI 
(Hierarchy (Operator |(Online flag) 
reason flag) reason flag) 


UCBNRY UCBNOCON | UCBENABL 
(Notready | (Not Enabled for 


flag) connected [interruptions 
flag) flag 








UCBVALPH | UCBDUC 


Path valida- | Display 
tion flag device unit 
check flag 


Wa] Jo Ajtodoig — sjeliay8yQy pasuzory 
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Diagram 15. Non-Direct Access Device Initialization (IEAVNPA2) Part 4 of 4 


Extended Description Module Label 


3 The JOS RIM uses the DCQ to select the UCBs foreach [IOSVNPTH NPTHIO 
non-direct access device that was initialized at SYSGEN 

time. It calls (OSVNPTH to test the availability of each 

device. |OSVNPTH issues a STARTIO macro instruction 

with an |/O NOP CCW command along each installed 

online path to determine if the device is physically available 

on that path. 


IOSVNPTH times all 1/O operations. If an operation does 
not complete within 1.5 seconds, the RIM Issues SVC 16 to 
purge the operation and resets tha logical path mask to 
indicate that the channel path is offline. 


If any path to the device verifies successfully, IOSVNPTH NPTHSTIO 
sets the following UCB fields: 


Field initalized Initialization value 


UCBONLI *1’ — device is online 

UCBLPM indicates what Paths are available to 
the device 

UCBVALPH ‘0’ — indicates a path has been verified 


for this device 


If there are no valid paths to the device, IOSVNPTH marks 
the device offline, sets UCBLPM to the initial state (the 
same value as the path installed mask) and sets fields 
UCBVHRSN and UCBVORSN to indicate why the 

device is offline. 


If after the above processing, the device is to be brought DEVINIT 
online and a device initialization exit exists for the 

device, then |OSVNPTH issues a sense-id command. The 

device initialization exit then initializes any feature fields 

unique to this device. If the exit fails, the device is marked 

offline. 


After the !OS RIM has verified all paths to non-direct access 
devices, it returns control to IEAVNIPM. 


Wa] jo Ayadoig — sjetsajeyal pesuaory 


uWal $0 Spetsaye]A] p23211352y,, 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Diagram 16. NIP Console Initialization (IEAVNPC1) Part 1 of 5 
IEAVNPC1 = MODULE DESCRIPTION 


DESCRIPTIVE NAME: NIP Console Initialization Routine 


FUNCTION: 

The IEAVNPC1] load module is responsible for selecting the 
NIP console and identifying it to IEAVNIPM for initial 
operator communications. 


ENTRY POINT: IEAVNPCI 

PURPOSE: See function above. 

LINKAGE: Call from IEAVNIPM. 

CALLERS: IEAVNIPM. 

INPUT : 
ITEANCTxx - Member of SYS1.NUCLEUS containing descriptions of 

candidate NIP consoles. 

OUTPUT: NIP console identified. 

EXIT NORMAL: Return to caller via register 14. 
OUTPUT: See output above. 

EXIT ERROR: 
Abnormal return to the NIP system wait state routine in 
IEAVNIPM, via a branch. The wait state routine is located 
using the NIP Vector Table (NVT). 


The following abnormal conditions may occur during processing 
by IEAVNPC] routine and will result in a system wait state: 


If no active NIP console is found, a '07'X wait state 
code is placed in the NIP Vector Table (NVTFLWSC), and 
IEAVNPC] exits to the IEAVNIPM wait routine (NIPSWAIT 
via NVTSWAIT) to place the system in a disabled wait 
state. 


The IEANCT member may not be found. This will cause the 
LOAD to fail. 


EXTERNAL REFERENCES: 
ROUTINES: NIP Control/Service Routine (IEAVNIPM). 


CONTROL BLOCKS: 
COMMON NAME MAPPING DESCRIPTION 


CVT CVT Communications Vector Table 
DCB IHADCB Data Control Block 
IHADCBDF 
DEB IEZDEB Data Extent Block 
NCT IEANCT NIP Console Table 
NVT IHANVT NIP Vector Table 
UCB IEFUCBOB Unit Control Block 
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Diagram 16. NIP Console Initialization (IEAVNPC1) Part 2 of 5 
IEAVNPC1 = MODULE OPERATION 


Load the NIP Console Table (NCT) from SYS1.NUCLEUS. 


Verify the consoles in the order that they reside in the 
NIP Console Table searching for a valid console. A console 
is valid if: 


(A) the device is online 

(B) the device is connected 

(C) the device is path installed 
(D) the device is ready 

(E) the device is not unit checked 


When a valid console has been found: 


Set the appropriate bits to indicate that the NIP console 
is active. Save the address of the console. 


If no valid console is found, a '007'X wait state code is 
placed in the NIP Vector Table (NVTFLWSC), and IEAVNPC1 
exits to the IEAVNIPM WAIT routine to place the system in 
a disabled wait state. 
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Diagram 16. NIP Console Initialization JTEAVNPC1) Part 3 of 5 
IEAVNPC1 - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAVNPC1 
MESSAGES: None 
ABEND CODES: None 


WAIT STATE CODES: 


Hexadecimal disabled wait state codes issued via NIPSWAIT: 
'007'X - No valid NIP console was found 


RETURN CODES: None 


REGISTER CONTENTS ON ENTRY: 


Irrelevant 

Irrelevant 

NIP Vector Table address 
CVT address 

4 to 13 - Irrelevant 

14 - Return address 

15 - Entry point address 


WN Ee © 
1 ef 8 a 


REGISTER CONTENTS ON EXIT: Irrelevant 
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Diagram 16. NIP Console Initialization GEAVNPC1) Part 4 of 5 
IEAVNPC1 = NIP Console Initialization Routine STEP O01 


IEAVNIPM. 
The IEAVNPC1 load module is responsible 
N for selecting the NIP console and 
>| | identifying it to IEAVNIPM for initial 
/ operator communications. 
IEAVNPC1 





o1 Top segment loops through 
the table and invokes the 
validation routine. The loop 
is exited at end-of-table to 
an exit-error state, or toa 
routine which processes a 
valid console. 


A. Obtain the NIP console table 
i 
\r—7 FINDNCT: 02 


IEANCT \| B. Read through each entry in the NCT until 
/ a valid console has been found or the 
NC TCOUNT end of table is reached 


C. Determine if console is valid 
i 
\r—7 VALCON: 03 


NVT \] D. If no valid console is found, enter a \NVT 


/ wait state. 17 
NVTFLANC NVTFLWSC 


E. Valid console found - identify it to NIP \IEANCT 


/ 
F. Identify active console to NIP NCTACTIN 
/_AN 


\r—/ PROCCON: 04 


*EINDNCT” - This routine 
will obtain the member name 
where the NIP console table 
resides, lead the member 
from SYS1.NUCLEUS, and save 
its starting address. 


CVT . Create the NCT member name using 
“ITEANCT" and the I/0 configuration 
CVTIOCID identifier from the CVT. 


NVT . Setup and issue the load and save the 


load address. 
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Diagram 16. NIP Console Initialization (IEAVNPC1) Part 5 of 5 
ITEAVNPC1 - NIP Console Initialization Routine STEP 03 





"VALCON" - This routine 
validates a console to 
determine if it can be used 


as the NIP console. A valid 
console is online, not unit 
checked and ready.. 


IEANCT \]| A. Call UCB FIND routine to obtain the \IEANCT 
/ address of device's UCB. / 
NCTDNBR | NCTUCB 





MAP procoo-- >| B. determine if device is valid and if so, \MAP 
/ 


: \ a valid console has been found. 


UCB 










"“PROCCON" = This routine \DEB 
will identify the valid / 

ITHADCB console to IEAVNIPM and set 
all necessary flags in the 

: control blocks. 
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Diagram 17. Direct Access Device Initialization (IEAVNPB6) Part 1 of 2 
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Diagram 17. Direct Access Device Initialization (IEAVNPB6) Part 2 of 2 


Extended Description Module Label 


IEAVNIPM calls the input/output supervisor (IOS) RIM, at 
entry point |EAVNPB2, to test the sharability and availability 
of all real direct access devices. It also initializes their unit 
control blocks (UCBs). 


1. The lOS RIM uses the device class queue (DCQ) to 

select the UCBs for direct access devices and calls the 
service routine IOSVNPTH to test the availability of each of 
these devices. IOSVNPTH issues a STARTIO macro instruc- 
tion along each installed path to determine if the device is 
physically available on that path. 


(EAVNPOZ2 


IOSVNPTH NPTHIO 


When a Gevice is marked sharable at sysgen (UCBRR=1), 
IOSVNPTH verifies its sharability using a RELEASE CCW 
command. If the device doesn’t have this capability, it 
rejects the RELEASE command. IOSVNPTH sets the flags 
UCBSHRUP and UCBRR to indicate that the device is not 
sharable. 


If the device was designated as not sharable at sysgen. 
IOSVNPTH issues an 1/O NOP CCW command. 
IOSVNPTH times all 1/O operations. If an operation does NPTHSTIO 
not complete within 1.5 seconds, IOSVNPTH prompts the 

operator to indicate whether the processing should continue 

or whether the system should wait for the operation to 

complete. (The device may be reserved by another system). 

If the Operator indicates that processing should continue, 

IOSVNPTH purges the operation, marks the channel path 

offline for the device and processes the next path for the 

device. Otherwise, the system waits until the operation 

completes. 


If any path to the device verifies successfully, IOSVNPTH 
sets the following UCB flags: 


Field initialized Initialization value 

UCBONLI *1’—device is online 

UCBLPM indicates what paths are available to the 
device 

UCBVALPH ‘Q’—indicates a path has been verified for 
this device 


Extended Description Module Label 


If there are no valid paths to the device, IOSVNPTH marks 
the device offline, sets the logical path mask (LPM) to the 
initial state (the same value as the paths Installed mask), 
and sets fields UCBVHRSN and UCBVORSN to indicate 
why the device is offline. 

lf, after the above processing, the device is to be brought DEVINI 
online and a device initialization exit exists for the 

device, then IOSVNPTH issues a sense-id command. The 

device initiatization exit then initializes any feature fields 

unique to this device. If the exit fails, the device is marked 

offline. 


2 The lOS RIM checks for duplicate volume serial numbers IEAVNPO2 
for online direct access devices. To obtain the volume 
serial number for a device, the |OS RIM issues an |/O opera- 
tion. The operation consists of SEARCH, TIC, and READ 
commands. The IOS RIM places the volume serial number 
and the VTOC TTR for each direct access device, except 
SYSRES, into the UCB that corresponds to the device. 
If it finds a duplicate serial number, it issues message 
IEA212A to request that the operator demount one of the 
volumes, After the operator responds with the device 
number, the |OS RIM places zeroes in the volume serial 
number and VTOC fields of the UCB for the device that had 
the volume to be demounted, marks the device offline and 
not ready, and sets the operator reason flag in the UCB 
(UCBVORSN=1). 


NP2READ 
NP2LDUP 


The IOS RIM returns control to IEAVNIPM. 
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Diagram 18. System Parameter Analysis and Data Set Opening (IEAVNP03) Part 1 of 4 
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Diagram 18. System Parameter Analysis and Data Set Opening (IEAVNP03) Part 2 of 4 


Extended Description Module 
The NIP RIM, IEAVNPO3 checks the syntax of the system 

parameters that were specified in SYS1.PARMLIB {including 
Installation-specified parameters) or by the operator and 

places these parameters in the PARMT AB. It processes the 

SYSP, LNK, and LNKAUTH psrameters and calls 

tEAVNPAS to process the APF parameter. IEAVNPO3 

opens the system data sets, SYS1.PARMLIB and data sets 

specified as part of the LNK LST concatenation. 


Except for opening the two system data sets, this routine is 
the code of NIP PROMPT service, NIPPRMPT. The NIP 
PROMPT service is called when the operator responds to a 
message requesting that system parameters be respecified. 
At this time, IEAVNPO3 checks the syntax of the new 
parameter and puts it in PARMTAB. 


1 NIP assumes either that the system catalog defines the IEAVNPO3 
location of SYS1.PARMLIB or, if S¥S1.PARMLIB 
is not cataloged, that the data set resides on the system 
residence volume. First, NIP issues a LOCATE SVC to read 
the system catalog entry for SYS1.PARMLIB. If the 
LOCATE is successful, NIP extracts the volume serial 
number for SYS1.PARMLIB from its catalog entry and 
passes control to the NJPMOUNT service routine to ensure 
that the volume is mounted. NIPMOUNT returns the related 
UCB address in register 1. If the LOCATE is not successful 
(SYS1.PARMLIB is not cataloged), NIP assumes that 
SYS1.PARMLIB is on the system residence volume: NIP 
obtains the related UCB address from field CVTSYSAD. 


IEAVNP12 


IEAVNPM3 


NIP places the appropriate UCB address in the NIPOPEN 
parameter list. 


NIP issues the GETMAIN macro instruction to obtain 
storage from the private area (subpool 252) for the 
SYS1.PARMLIB DCB and sets NVTPLDCB to point to the 
DCB. 


IEAVNPM2 


After NIP opens SYS1.PARMLIB, it returns the block size in 
PARMAREA. If the blocksize is not a multiple of LRECL 
80, NIP issues error message IEA333A and continues 
processing the operator’s request by rounding the blocksize 
up to a multiple of 80. NIP issues the GETMAIN macro in- 
struction to obtain the storage from the private area for a 
buffer the length of the block. NVTPLBFS points to this 
buffer. 


IEAVNPM3 


Label 


NP3PMLIB 


NIPMOUNT 


NP3PMLIB 


NIPWTOR 


NIPOPEN 


Extended Description Module 
Along with the UCB address, NIP places the address of the 
SYS1.PARMLIB DCB in the NIPOPEN parameter list. 

The NIPOPEN service routine then opens the 
SYS1.PARMLIB data set by building a DEB for the data set 
in the private area {subpool 252). 


IEAVNPM3 


2 From field NVTSPE, NIP obtains the address of the IEAVNPO3 
Operator’s reply to the SPECIFY SYSTEM PARAMN- 


ETERS message. NIP examines the reply: 


e If the operator specified system parameters, NIP scans the 
parameters for validity and places the addresses of the 
specified parameter values into preassigned fields in 
OPERTAB. 

@ NIP reads a block of text records from IEASY SOO into a 
buffer and returns a single record at atime. |t scans the 
parameters in each text record for validity, then places 
the addresses of the parameter values into their respective 
fields in PLIBTAB. The format of PLIBTAB is identical 
to that of OPERTAB. 

e If the operator specified SYSP, indicating that parameters 
come from requested IEASY Sxx members of 
SYS1.PARMLIB, NIP first processes the |EASYSOO mem- 
ber, then each |EASYSxx member specified by SYSP. 
NIP reads text records from each |EASYSxx member, 
scans each text record, and places the addresses of 
the specified parameter values into PLIBTAB. Parameter 
values from the last IEASYSxx member read override 
previous IEASYSxx values for those parameters. 


IEAVNPM4 
IEAVNPO3 


NIP merges parameters from OPERTAB into PLIBTAB; as 
it merges the parameters, NIP overrides PLIBTAB entries 
with any valid operator-specified values for those entries. 
(The exceptions to this are: the PAGE parameter, which 
allows the operator specification to be merged with the 
SYS1.PARMLIB specification; and parameters for which 
the installation specified OPI=NO.) 


Finally, NIP initializes PARMTAB in PARMAREA: for 
each parameter that has a nonzero entry in PLIBTAB, NIP 
moves the input data into PARMTAB. For active keyword 
parameters that have no input data, NIP places an address 
value of X'0A’ in PARMTAB. For a description of 
PARMTAB, refer to the “Data Areas” section of this pub- 
lication and to Data Areas. 


Cc 
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NIPOPEN 
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NP3SY SP 
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NP3PLMRG 
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Diagram 18. System Parameter Analysis and Data Set Opening (IEAVNP903) Part 3 of 4 
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3 Open the LNKLST 
concatenation headed 
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e Build the APF 
table 


See Diagram 16. 
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Diagram 18. System Parameter Analysis and Data Set Openmg (IEAVNP03) Part 4 of 4 


Madule Label 


Extended Description 


3 NIP assumes that the system catalog defines the 

location of the SYS1.LINKLIB data set. NIP issues a 
LOCATE macro instruction to read the system catalog 
entry for SYS1.LINKLIB. If the LOCATE is successful, 
NIP extracts the volume serial number for SYS1.LINKLIB 
from its catalog entry and calls the NIPMOUNT service 
routine to ensure that the required volume is mounted. 
NIPMOUNT returns the related UCB address in register 1 
and NIP places the address in the NIPOPEN parameter 
list. 


IEAVNPOS3 NP3LKLIB 


IEAVNPM3 


IEAVNPO3 NP3LKLIB 


Next, NIP retrieves the address of the SYS1.LINKLIB DCB 
from field CVTLINK and places it in the NIPOPEN param- 
eter list. NIP then calls the NIPOPEN service routine, which 
opens the SY$1.LINKLIB data set by building a DEB in the 
SQA for the data set. NIPOPEN marks the UCBSTAT for 
the SYS1.LINKLIB volume permanently resident and allo- 
cated, and increases the use count (UCBUSER). NIPOPEN 
Indicates in the DEB that the data set is an authorized pro- 
gram library. After NIP opens the SYS1.LINKLIB data set, 
NIP concatenates installation-specified data sets with 
SYS1.LINKLIB to create the system link library (the 
LNKLST concatenation). The installation specifies these 
data sets by entering their data set names in LNK LSTxx 
member(s) of SYS1.PARMLIB and by specifying the LNK 
system parameter. (If the installation does not specify 
LNK, NIP attempts to find the LNKLSTOO member.) 


IEAVNPM3 NIPOPEN 


IEAVNPO3 NP3LCAT 


C 


NIPMOUNT 


Extended Description Module Label 
NIP obtains an 8K-Dyte workarea to build a table of data set 

names from the input LNKLSTxx member(s). NIP reads 

each record from the requested LNKLSTxx member(s), 

scans the record, and enters the data set names in the 


workarea. 


Next, NIP processes each entry in the workarea, as follows. 
First, NIP issues a LOCATE macro instruction for the data 
set names in the entries. If the locate is successful, NIP 
initializes the corresponding entry with the volume ID 
returned from the catalog entry. If LOCATE is not success- 
ful, NIP flags the entry unavailable, After LOCATE, NIP 
passes each available entry to the NIPMOUNT service 
routine to mount the volume. NIPMOUNT returns 

the UCB address of the mounted volume. NIP places the 
UCB address along with the DCB address from field 
CVTLINK into the NIPOPEN parameter list. Finally, NIP 
passes control to the NIPOPEN service routine to con- 
catenate the current data set with the previously defined 
portion of the link library. If the data set is successfully 
opened, NIPOPEN sets the corresponding UCBSTAT to 
permanently resident and allocated, and increases the use 
count (UCBUSER). 


NIPMOUNT 
NP3LCAT 


IEAVNPM3 
IEAVNPO3 


IEAVNPM3 NIPOPEN 


If too many data sets or extents were specified, IEAVNPO3 IEAVNPO3 NP3LCAT 
truncates the LNK LST, issues message [EA328E and stores 

the LNKLSTxx suffix in the LNKLST lookaside (LLA) 

control block for LLA to reissue IEA328E when thesystem 


Is initialized. 


ITEAVNPO3 calls IEAVNPAS to build the APF table in the 
SQA. IEAVNPO3 processes the LNKAUTH parameter and 
builds the LNK LST table (LLT) in the SQA. The LLT con- 
tains the LNKLST data set names and flags that indicate 
which LNKLST data sets are APF authorized. If at least 
one LNKLST data set is not APF authorized, IEAVNPO3 
turns off DEBAPF IN to indicate that the concatenation is 
not authorized as a whole. 
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Diagram 19. Autherized Program Facility Table Initialization (IEAVNPAS) Part 1 of 2 
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Diagram 19. Authorized Program Facility Table Initialization (IEAVNPAS) Part 2 of 2 


Extended Description Module Label} 


The authorized program facility (APF) permits the in- IEAVNPO3 

stallation to identify system or user programs that are al- 

lowed to use restricted system functions. The APF table 

contains an entry for each Jibrary of authorized programs. 

The APF table entry contains the length of the entry, the 

volume |D of the volume on which the library can be found, 

and the library name. The NIP RIM IEAVNPOS3 calls IEAVNPA5 NPASAPF 
IEAVNPAS to build the APF table in SQA as follows: 


1. JIEAVNPAS always constructs an entry for 

SYS1.LINKLIB. IEAVNPAS obtains the volume ID 
from the UCB for SYS1.LINKLIB; and the SYS1.LINKLIB 
DCB address from field CVTLINK. It follows a chain of 
pointers to the UCB. Then, IEAVNPAS constructs an APF 
table entry for SYS1.LINKLIB. 


2  \EAVNPAS always constructs an entry for 
SYS1.SVCLIB. IEAVNPAS obtains the volume ID 
from the UCB for SYS1.SVCLIB; IEAVNPAS obtains the 
SYS1.SVCLIB DCB address from field CVTSVDCB and 
follows a chain of pointers to the UCB. Then, |EAVNPAS 
constructs an APF table entry for SYS1.SVCLIB. 


3 ~The installation can specify authorized libraries by 

listing them in a member or members of 
SYS1.PARMLIB named [EAAPF xx and using the APF sys- 
tem parameter to indicate the suffix for IEAAPFxx. After 
It initializes the SYS1.LINKLIB and SYS1.SVCLIB entries 
in the APF table, IEAVNPAS checks the APF parameter 
entry in PARMTAB to determine whether the installation 
specified authorized libraries. If the parameter entry in 
PARMTAB is not zero, it contains the suffix or suffixes 
for IEAAPF xx. IEAVNPAS builds an APF table entry for 
each library listed in the IEAAPFxx member of 
SYS1.PARMLIB. 
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Diagram 20. REAL Parameter Initialization (IEAVNPES8) Part 1 of 2 
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Diagram 20. REAL Parameter Initialization (IEAVNPES) Part 2 of 2 


Extended Description Module Label 


IEAVNIPM calls the real storage manager (RSM) RIM, 
|IEAVNPES, to process the REAL parameter. This parameter 
specifies the amount of storage to be reserved for programs 
running V=R (that is, programs in which the real address 

and the virtual addresses must be the same). The RSM RIM 
marks all the page frame table entries (PF TEs) for frames 

in the resulting V=R region, and marks the appropriate 
address increment map entries (AIMEs). 


After the VSM RIM, [EAVNPB8, initializes the CSA, the 
RSM RIM, [EAVNPDS, will make necessary adjustments 


to the contro! blocks .that describes the V=R region. 


1. The RSM RIM checks the syntax of the REAL parameter |EAVNPES8 
specified by the operator. If the parameter is not valid, 

the RIM issues message number |AROQGA to request that 

the operator respecify a new value for the REAL parameter. 


2 The RSM RIM marks each frame in the V=R area that 

is set up Dy the REAL parameter as non-preferred, V=R 
candidate frames. If any of the frames in the V=R area are 
already in use for the non-extended system queue area (SQA), 
the local system queue area (LSQA), or part of a double frame 
pair, the RSM RIM marks the frames as frames that are 
polluting the V=R area. 


3 > The RSM RIM marks the AIME for each band in the 
VER region that contains: 


e All V=R candidate frames (AIMVEQR=0) 
@ Not all preferred frames (AlIMPREF=0) 
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Diagram 21. Global Resource Serialization Control! Block Initialization (IEA VNP23/ISGNCBIM) Part 1 of 4 
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Diagram 21. Global Resource Serialization Control! Block Initialization (IEA VNP23/ISGNCBIM) Part 2 of 4 


Extended Description 


IEAVNIPM calls the global resource serialization RIM, 
ISGNCBIM, to obtain storage for and initialize the global 
resource serialization control blocks before the creation of 
the global resource serialization address space, ISGNCBIM 
is the first global resource serialization RIM to receive con- 
trol. (ISGNTASC is the other RIM.) IEAVNIPM invokes 
ISGNCBIM in supervisor state and in key O. 


Note that IEAVNIPM knows ISGNCBIM as IEAVNP23, 
ISGNCBIM isan entry point in load module IEAVNP23. 


1 'ISGNCBIM obtains storage for the following control 
blocks and data areas: 


Global resource serialization vector table extension 
(GVTX) 

Local queue hash table (LQHT) 

Local resource pool table (LRPT) 

Resource queue area (ROA) 

Queue work block (QWB) 

Storage manager parameter list (SMPL) 

ENQ/DEO work areas, which are the global queue work 
area (GQWA), local queue work area (LQWA), global 
group summary area (GGSA), and local group summary 
area (LGSA) 


ISGNCBIM issues the GETMAIN macro instruction to obtain 
the storage from SQA, subpool 245, ISGNCBIM obtains 
approximately 12K of storage. 


Module 


Label 


Extended Description Module Label 


2 ISGNCBIM formats and initializes the GVTX, LRPT, 
and LOHT. ISGNCBIM places the address of the LRPT 
in the GVTX (GVTXLRFPT) and the address of the LOQHT 
in the GVTX (GVTXLOHT). ISGNCBIM initializes a bit 
map to all ones and store its address in the GVTX 
(GVTXBTMP). This bit map is used to identify the pages in 
the ROA that are allocated to the global resource 
serialization storage manager and the ones that are not. 
ISGNCBIM sets the bit map to all ones because, at this time, 
all pages in the ROA are allocated and fixed. ISGNCBIM 
initializes the GVT X with the address of the ROA 
(GVTXRQA). ISGNCBIM also initializes the GVT with the 
address of the QWB and with the addresses of the ENQ/DEQ 
work areas: GOWA, LOWA, GGSA, and LGSA (GVTGOQWA, 
GVTLQWA, GVTGGSA, and GVTLQSA). ISGNCBIM 
then initializes the pool extent blocks (PEXBs). A PEXB 
maps a portion of the RQA and contains cells for one of the 
following control blocks: 


QWB — queue work block 

QXB — queue extension block 

QEL — queue element 

OCB — queue control block (either a small, medium, or 
large QCB) 


ISGNCBIM initializes the storage manager parameter lists 
(SMPLs). Each SMPL represents a request to the global re- 
source serialization storage manager and identifies the storage 
associated with a particular control block or data area. A 
SMPL exists for the following control blocks and data areas: 
OWB, QOXB, QEL, and QCB (either small, medium, or large). 
Note that, because there are only a limited number of control 
blocks available at this time for processing enqueue or 
dequeue requests, concurrent ENQs/DEQs will be limited. 
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Diagram 21. Global Resource Serialization Control Block Initialization (IEAVNP23/I1SGNCBIM) Part 3 of 4 
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Diagram 21. Global Resource Serialization Control Block Initialization (IEAVNP23/ISGNCBIM) Part 4 of 4 


Extended Description Module 


3. ISGNCBIM issues a BLDL macro instruction to obtain ISGNCBIM 


the size of a module ISGGQWBC, ISGGQWEC is the 
global resource serialization QWB copy routine, which 
resides in SYS1.LINKLIB. Using the size of the ISGGQWBC 
module, ISGNCBIM issues a GETMAIN macro instruction to 
obtain storage from SQA (subpool! 245). ISGNCBIM then 
issues the LOAD macro instruction to load |ISGGQWBC 
directly into this acquired storage. ISGNCBIM saves the 
address of ISGGQWBC in the GVT (GVTGQWBC) and also 
its size so that the storage it occupies can be released later. 


ISGNCBIM 
IEAPMNIP 


4 ISGNCBIM ensures that the GRS system parameter is 
either NONE, JOIN, or START. If the parameter is 
valid, ISGNCBIM sets the appropriate flag in the GVT: 


GRS=NONE GVTNONE="‘1' 
GRS=START GVTSTART='1’ 
GRS=JOIN GVTJOIN=‘1' 


Otherwise, ISGNCBIM asks the operator (using the 
NIPWTOR service routine) to respecify the GRS parameter. 


ISGNCBIM 
IEAPMNIP 


Ff ISGNCBIM verifies the data specified for the 
SYSNAME= system parameter. If the parameter is 
valid, ISGNCBIM stores the SYSNAME in the CVT 
CVTSNAME) and the GVT (GVTSYSNM). Otherwise, 
ISGNCBIM issues message |1SG041I and prompts the operator 
with message [|EAQ06A. When control is returned, 
ISGNCBIM verifies the new data specified for the 
SYSNAMEE= system parameter. When the SYSNAME= 
system parameter is valid, processing continues at step 6. 


6  ISGNCBIM calls the global resource serialization CTC ISGJPARM 
configuration parmlib processor (ISGJPARM) to 
parse the GRSCNF system parameter and the GRSCNF xx 


SYS1.PARMLIB member. 


Label 


Extended Description 


7 ISGNCBIM calls the global resource serialization 

resource name list parmlib processor (ISGNRNLP) 
to parse the GRSRNL system parameter and to parse the 
GRSRNLxx SYS1,PARMLIB member(s). 


8 ~=sCiIf the GRS system parameter is either START or JOIN, 

ISGNCBIM notifies the NUCLKUP service routine to 
set the entry point addresses and the addressing mode bits of 
the SYSTEM inclusion, SYSTEMS exclusion, and the 
RESERVE conversion exits in the GVT. 


If an error was encountered by ISGNRNLP 
(GVTRNLER = 1), ISGNCBIM deactivates global resource 
serialization. 


lf an error was encountered by ISGJPARM 

(GVTCNFER = 1), ISGNCBIM deactivates global resource 
serialization only if ISGNRNLP also encountered an error 
(that is, only if GVTRNLER also is 1). If only 
GVTCNFER = 1, ISGNCBIM activates global resource 
serialization to allow ISGBTC to display GRSCNF xx error 
messages. Then ISGNASIM deactivates global! resource 
serialization. 


If the GRS system parameter is NONE (GVTNONE=‘1’), 
ISGNCBIM indicates that global resource serialization is 
inactive (sets GVTGRSNA to 1) and that the GRS option 
processing is complete (sets GVTGRSPC to 1). 


Recovery Processing 


None. 


Module 


ISGNRNLP 


ISGNCBIM 


C 


Label 
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— Diagram 22. Global Resource Serialization CTC Configuration Parmlib Processor (ISGJPARM) Part 1 of 4 

—_ 

GO 

NO 

<= ISGNCBIM 

= Input Process 

ee, 

S CVT GVT. 

4 Ce Quit processing for Return 

g GVTNONE GRS=NONE., to caller 
a a 

e. 

re 

° 

qe. 

fe) 


GRSCNF= 


Validate the GRSCNF 


data system parameter. 








Process any invalid 
GRSCNE data. 


ISGNPARS 


Parse 
setup 


routine 


L861 ‘7861 “4302 Wal 148uhdoy @ F-00ZI-8Z7AT 








Output 


Prompt |EAS06A 


Message ISGO042!I 





Wa] Jo Aysdosg — syeisajzeyal posuaoiy 


«WGI JO STB ye]A] PPP ISO, 


L861 ‘7861 “dtog Wa Wy8UAdoD © F-007I-87AT 


uoneJedGO Jo poy, “s UOTIIEg 


€8I-¢ 


C ( 


Diagram 22. Global Resource Serialization CTC Configuration Parmlib Processor (ISGJPARM) Part 2 of 4 


Extended Description Module Label 


ISGJPARM parses the GRSCNF system parameter used to 
initialize global resource serialization and the 
SYS1.PARMLIB members, GRSCNFxx. ISGJPARM resides 
in the IEAVNP23 load module. 


1 If GRS=NONE was specified (GVTNONE='1'), 
then this system is not part of a global resource 
serialization complex. ISGJPARM returns to the caller. 


2  ISGJPARM verifies the data specified for the GRSCNF= 
system parameter. The xx must consist of two alpha- 
meric characters and be syntactically correct. 


3. =«If the GRSCNF= system parameter is invalid, 

ISGJPARM issues message |SG042I and prompts the 
operator with message |EASO6A. When control is returned, 
processing continues at step 2. 


If the GRSCNF= system parameter is valid, processing con- 
tinues at step 4. 
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Diagram 22. Global Resource Serialization CTC Configuration Parmlib Processor (ISGJPARM) Part 3 of 4 
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Diagram 22. Global Resource Serialization CTC Configuratien Parmlib Processor (ISGJPARM) Part 4 of 4 


Extended Description Module 


4 I\ISGJPARM calls the global resource serialization ini- 

tialization parse setup module (ISGNPARS) which 
sets up to parse the GRSCNFxx SYS1.PARMLIB member. 
(IEEMB887 parses the GRSCNFxx SYS1.PARMLIB 
member. ) 


If the first record of the SYS1.PARMLIB member was not IEAPMNIP 
read successfully by ISGNPARS, RORTNEOR (a subroutine 

in ISGJPARM) receives control to process the error as 

follows: 


@ If the GRSCNFxx member does not exist, ISGJPARM 
issues Message |EA301!1 and prompts the operator for IEAPMNIP 
a new GRSCNFxx member with message IEASOQGA. If 
the operator specified an end-of-block {(EOB) anda 
default member does not exist, ISGJPARM goes to step 
5 to build a global resource serialization CTC-driver 
control card table (GCC) which indicates the error. 


Note: |f the read processing is successful, IEEMB887 calls ISGJPARM 
exit routines in ISGJPARM according to the data found 
in the GRSCNFxx SYS1.PARMLIB member. 


5 sf no errors have occurred, ISGJPARM builds a GCC lIOSLOOK 
control block. This GCC control block contains all 

the information specified on the GRSDEF control statement 

that matches the system. ISGJPARM stores the UCB address 

of the CTC adapter for the system in the GCC control block. 


lf errors exist, ISGJPARM builds a GCC control block to GETMAIN 
contain the appropriate error flag. 


ISGJPARM then returns to the caller. 
Recovery Processing 


None. 


Label 


RORTNEOR 


PROCSTAT 
MTSYSFD 
RSMLFD 
CTCFD 
RESTFD 
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Diagram 23. Global Resource Serialization Resource Name List Parmlib Processor (ISGNRNLP) Part 1 of 6 


Input 


CVTGVT GVTNONE 


Register 2 


NVTPTAB 


PARMTAB 


DATA 


ISGNCBIM 


Process 


Quit processing for GRS=NONE. 


Validate the GRSRNL system parameter. 


Process any invalid GRSRNL data. 


Obtain storage for temporary RNLs. 


Return to 
the caller. 


Output 


Message |SG061I 


Message |EAS06A 





Wal go Apadosg — sjeiazeyy posuasiy 


GIANG JO Sela zBIA) p2yLysay, 


L861 ‘7861 “d20D Wa 1u8uAdoD @ 4-0071-87AT 


uotjesadg Jo poyley “¢ UOTNIES 


L8I-S 


C 


C 


Diagram 23. Global Resource Scrialization Resource Name List Parmlil) Processor (ISGNRNLP) Part 2 of 6 


Extended Description 


ISGNRNLP validates the GRSRNL=(xx,yy,.. .) system 
parameter, parses the GRSRNL member(s) of 
SYS1,.PARMLIB, and builds the resource name lists (RNLs} 
in SQA storage. ISGNRNLP resides in the IEAVNP23 load 
module. 


1 If the GRS=NONE was specified (GV TNONE="1’), then 
this system is not to be part of a global resource seriali- 
zation complex. ISGNRNLP returns to the caller. 


2  ‘\ISGNRNLP verifies the data specified for the 

GRSRNL= system parameter. The (xx,yy,. . .) must 
consist of two alphameric characters and be syntactically 
correct. 


3 If the GRSRNL#&=‘system parameter is invalid, 

ISGNRNLP issues message |SGO61! and prompts the 
operator with message JE ASOGA to re-enter the system para- 
meter correctly. When control is returned, processing con- 
tinues at step 2. (Note: ISGNRNLP keeps prompting the 
operator until the system parameter is valid.) 


If the GRSRNL= system parameter is valid, processing con- 
tinues at step 4. 


4  ISGNRNLP obtains (viaa GETMAIN macro instruction) 
a buffer in subpool! 127 for each resource name list 
(RNL). 


Module 


ISGNRNLP 


ISGNRNLP 


[IEAPMNIP 


ISGNRNLP 


Label 


VALDTEXX 


GETSTOR 
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Diagram 23. Global Resource Serialization Resource Name List Parmlib Processor (ISGNRNLP) Part 3 of 6 


Input Process Output 
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Diagram 23. Global Resource Serializatien Resource Name List Parmlib Processor (ISGNRNLP) Part 4 ef 6 


Extended Description Module Label 
5 ‘For each GRSRNL&=(xx,yy, ...) system parameter 
specified, ISGNRNLP calls the global resource serial- ISGNPARS 


ization parse setup module (ISGNPARS), which uses the 
NIP service routine, or IEAVNPM4 IEAPSIO, to read the 
first GRSRNLxx SYS1.PARMLIB member record, (The 
suffix, ‘xx’, represents one xx,yy,. .. pair specified for the 
GRSRNL= system parameter.) If the read was successful, 
ISGNPARS invokes the generalized parser (IEEMB887) to 
parse the specified GRSANLxx SYS1.PARMLIB member. 


If the first record of the member was not read successfully, 
ISGNPARS calls asubroutine (RDRTNEOR) in ISGNRNLP 
to process the error as follows: ISGNRNLP RDRTNEOR 
@ If the GRSRNLxx member does not exist, RDRTNEOR 

does the following (message |EA3011 has already been 

sent to the operator): 


— |ISGNRNLP prompts the operator with message 
ISGO65D to elther reload the system or reply ‘U’ 
or ‘NONE’. ISGNRNLP validates the reply. 


— lf the operator responded with an invalid reply, 
ISGNRNLP issues the message |SGO0641 (indicating 
an invalid reply) and repests the previous prompt 
until the reply is valid. 


— If ‘NONE’ was specified, ISGNRNLP sets 
GVTRNLER=‘1’, Processing continues with step 9. 


— |f ‘U’ was specified, ISGNANLP processes the next 


GRSRNLxx member. IEAPMNIP RDRTNEOR 


Extended Description 


@ If ani/O error occurred that prevented thesystem from 
reading the GRSARNLxx SYS1,PARMLIB member, 
ISGNRNLP issues message |SGO62I and does the 
following: 


— ISGNRNLP prompts the operator with message 
|SGOO9D to either reload the system or reply 
‘NONE’. ISGNRNLP validates the reply. 


— If the operator responded with an invalid reply, 
ISGNRNLP issues message |SGO64I (indicating an 
invalid reply) and repeats the previous prompt until 
the reply is valid. 


— If ‘NONE’ was specified, ISGNRNLP sets 
GVTRNLER='1’. Processing continues with step 9. 


Note: If the processing is successful, |EEMBB87 calls exit 
routines in ISGNRNLP to build the SYSTEM inclusion 
RNL, SYSTEMS exclusion RNL, and RESERVE conver- 
sion RNL based on the contents of each GRSRNLxx 
SYS1.PARMLIB member. ISGNRNLP builds these RNLs 
temporarily in subpool 127. (ISGNRNLP excludes dupli- 
cate entries in the same RNL.) If the RNLDEF statement 
contains LINKLIB=YES, ISGNRNLP copies the RNLs 
from SYS1.LINKLIB, rather than SYS1.PARMLIB. 
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Diagram 23. Global Resource Serialization Resource Name List Parmlib Processor (ISGNRNLP) Part 5 of 6 
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Diagram 23. Global Resource Serialization Resource Name List Parmlib Processor (ISGNRNLP) Part 6 of 6 


Extended Description 


G ISGNRNLP checks the return code from ISGNPARS 
to determine if the processing of the GRSRNLxx 

member was successful. If GRSRNLxx was not processed 

successfully, ISGNRNLP processes the error as follows: 


e If asyntax error was found, ISGNRNLP issues message 
ISGO631. 


@ If an1{/O error occurred which prevented the system 
from reading the GRSRNLxx SYS1.PARMLIB member, 
ISGNRNLP issues message |SG0621. 


e After issuing the appropriate error message, ISGNRNLP 
prompts the operator to reload the system or reply 
‘NONE’ with message ISGOOSD. ISGNRNLP validates 
the reply. 


e@ If the operator responded with an invalid reply, 
ISGNRNLP issues the invalid reply message |SGO064I 
and repeats the previous prompt until the reply is 
valid. 


e@ If ‘NONE’ was specified, ISGNRNLP sets 
GVTRNLER@=‘1’. Processing continues with step 7. 


If GRSRNLxx was processed successfully, the RNLs are 
to be built from SYS1.PARMLIB (LINKLIB = NO), and 
more GRSRNLxx SYS1,.PARMLIB members were 
specified on the GRSRNL parameter, ISGNRNLP goes to 
step 5. 


J If all GRSRNLxx SYS1.PARMLIB members have 
been processed successfully and the RNLs are to be 
built from SYS1.PARMLIB, ISGNRNLP continues: 


@ Obtains storage (via the GETMAIN macro instruction) 
for the RNLs in subpool 245. 


e Copies the RNLs from SQA subpool! 127 to subpool 
245. 


e@ Informs the operator with message |SGO671 that the 
source of the RNLs is SYS1.PARMLIB. Processing 
continues with step 9. 


Module Label 


ISGNRNLP ERRMSSG 


IEAPMNIP 


IEAPMNIP 


[EAPMNIP 


IEAPMNIP 


ISGNRNLP 


ISGNRNLP GETSTOR 


ISGNRNLP COPYRNLS 


ISGNRNLP FREESTOR 


Extended Description 


8 


Module Label 


If all the GRSRNLxx SYS1.PARMLIB members are 
processed successfully and the RNLs are to be loaded 


from SYS1.LINKLIB (LINKLIB= YES), ISGNRNLP 
processes as follows: 


9 


ISGNRNLP obtains storage (via GETMAIN macro 
instruction with the LOC = (BELOW,ANY) operand) 
for ISGGRNLO from subpool 245. ISGNRNLP then 
loads the SYSTEM inclusion, the SYST EMS exclusion, 
and the RESERVE conversion RNLs (ISGGRNLO) 
into this storage. 


ISGNRNLP calls the global resource serialization 
resource name list verification routine (ISGGRNLV) 
to validate the RNLs. 


ISGGRNLV 


If the RN Ls are valid, ISGNRNLP informs the operator 
with message |SGO67! that the source of the RNLs is 
SYS1.LINKLIB. 


If any of the RNLs are invalid, ISGNRNLP informs the 
operator of the error and prompts the operator with 
message |SGO02D to reload the system or to reply 
‘NONE’. If the operator's reply is invalid, ISGNRNLP 
repeats the message and the prompt until a valid reply 
Is received. If ’NONE’ was specified, ISGNRNLP sets 
GVTRNLER to 1. 


ISGNRNLP frees (via the FREEMAIN macro instruc- 
tion) all of subpool 127 storage that was used to 


temporarily store the RNLs. 
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Diagram 24. Global Resource Serialization Parse Setup Routine (ISGNPARS) Part 1 of 2 
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Diagram 24. Glebal Resource Serialization Parse Setup Routine (ISGNPARS) Part 2 of 2 


Extended Description Module Label 


ISGNPARS initializes the parameter list for the generalized 
parser (IEEMB887) and invokes IEEMB887 to process the 

specified SYS1.PARMLIB member. ISGNPARS resides in 

load module [IEAVNP23., 


1. ISGNPARS uses the NIP service routine (IEAVNPM4) IEAPMNIP 
to prepare the first record of the specified 
SYS1.PARMLIB member to be read. 


2 = =If the specified SYS1.PARMLIB member is not foundor ISGJPARM 
there was an error encountered from reading the records ISGNRNLP 

of the SYS1.PARMLIB member, ISGNPARS notifies the read 

routine error routine (RDRTNEOR) to correct the error. 

(RDRTNEOR is a subroutine contained in the caller's 

routine.) 


If the error was corrected, ISGNPARS returns to step 1. If 
the error was not corrected, ISGNPARS returns to the caller. 


3. ISGNPARS initializes the scan parameter list (SCL) and 

then links to the generalized parser (1IEEMB887) to 
process the specified SYS1.PARMLIB member. (See the 
Command Processing section of the System Logic Library 
for a description of |EEMB887.) 


Recovery Processing 


None. 
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Diagram 25. Auxiliary Storage Management Initialization, Part 1 (IEAVNP04/ILRASRIM) Part 1 of 4 
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Diagram 25. Auxiliary Storage Management Initialization, Part 1 (IEAVNP04/ILRASRIM) Part 2 of 4 


Extended Description 


{1LRASRIM builds and initializes ASM control blocks and 
opens the PLPA, common, and (if requested) duplex page 
data sets. IEAVNIPM enters [LRASRIM during NIP 
processing. I|LRASRIM’s normal exit is to IEAVNIPM. 


ILRASRIM initializes ASM for cold, warm and quick starts. 
Unless otherwise specified, the processing is the same all 
three types or starts. Both |LRASRIM and ILRASRM1 
call |LRASRM2. ILRASRM2 contains service routines 
that parse data set names, call data set open modules, and 
fillin the TPARTBLE control block. 


Note that IEAVNIPM knows ILRASRIM as IEAVNPO4. 
ILRASRIM isthe entry point inthe load module |EAVNPO4. 


1 Load |LROPSOO, I|LRPREAD, and IEAVNPC8. In ad- 

dition, load the I|LRDVTBL table found in module, 
ILRASTBL. ILROPSOO, ILRPREAD and ILRDVTBL are 
required to open, read, and write to the page and swap data 
sets. 


Set ASMNOLCL so that no local page data sets are used 
until ILRTMIOO executes. |LRTMIOO resets ASMNOLCL. 


2 Issuethe GETMAIN macro instruction to obtain storage 
in ESQA (subpool 245) for the following: 
@ the quick start record (QSRCD) 
the extended quick start record (EQRSD) 


the work area for the quick start record extension 
(XQSRD) 


the temporary page activity reference table (TPARTBLE) 
the cache array table (CACHE) 
a data set work area (DSTBL) 


3 Use the input parameters in PARMTAB to locate and 
parse the input data. Scan and save the data for later 
use. Save the page data set names in the DSTBL. Use the 
IEAPMNIP service routine to prompt the operator to re- 
specify the PAGTOTL or PAGE parameters if they are in- 
valid. Process the page data set name strings. Verify that 
the necessary data sets (PLPA, common, and at least one 
local page data set) are specified. If the mecessary ones are 
not specified, end the IPL and issue message |EA935W to 
indicate that insufficient paging resources are specified. 


Module Label 


ILRASRIM RIMINIT 


ILRASRIM 


IEAPMNIP 


ILRIMMSG 


Extended Description 


4 Invoke 1LRASMR2 to open the first data set (the data 
set for PLPA) named in the DSTBL. If this is a cold 
or quick start, set the |LROPSPL reset flag to indicate that 
if the page data set resides on a cached auxiliary storage 
system, the ILRPREAD must reset the cache. Reset of 
the cached auxiliary storage subsystem that has a page 
data set causes a TPARTBLE flag {(TPARTRAP) to be set 


to invalidate future warm starts until the system is sufficiently 


initialized to allow a warm start. If an error occurs during 
ILROPSOO processing, use |LRIMMSG to issue an appro- 
priate error message. 


If this is acold start, initialize the TPARTBLE, QSRCD, 

and EQSRD. If this is a warm or quick start, read the 
first records of the PLPA into storage. (The first records of 
the PLPA data set contain the TPARTBLE, QSRCD, and 
EQSRD from the previous IPL.) If this read fails, issue mes- 
sage |EA939D to tell the operator to re-IPL or force a cold 
start. After the operator replies to IEAQ939D, issue message 
|IEA929E to indicate a forced cold start. If the readof PLPA 
is successful, check the TPARTRAP flag. If this is a warm 
start and the flag is on, a quick start is forced. The 
TPARTRAP flag indicates incomplete initialization of page 
data sets during a previous IPL where a page data set was a 
cached auxiliary storage subsystem whose cache was reset. 
The TPARTRAP flag is set to indicate loss of cache data. 
The TPARTBLE is written to the PLPA data set. 


6 The duplex data set is an optional page data set. The 

third entry in the DSTBL is reserved for the duplex 
data set name. If this is a cold start, store the duplex data 
set name. If this is a cold start, store the duplex data set 
parameter data in the DSTBL. If this isa warm or quick 
start and a duplex data set name is already inthe TPARTBLE, 
move the name to the DSTBL. Open the duplex data set 
named inthe DSTBL. If anerror occurs, issue an appropriate 
message. If this is a quick or warm start and only some of 
the slots on the PLPA were present on the duplex data set 
(not on the PLPA data set), issue the warning message 
IEA9271 and continue processing at step 7. 


Module 


‘ 


Label 


ILRASMR2 OPEN 


ILRIMMSG 


ILRASRIM 


ILRPREAD 


ILRIMMSG 


ILRASRIM 


ILRASRM2 


ILRIMMSG 


OPENDPLX 


OPEN 
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Diagram 25. Auxiliary Storage Management Initialization, Part 1 (IEAVNP04/ILRASRIM) Part 3 of 4 


Input Process 


7 Open the common paging 
data set. 


NVTQSBUF 


8 Rebuild the PLPA paging 
tables for a quick or warm 
start. 





Q Delete |LROPSOO, 
|LAPREAD, and |EAVNPC8. 
Save pointers in the 
TPARTBLE pointer in the 
ASMVT. 


IEAVNIPM 


Output 








TPARTBLE 






ILRASRM2 


ASM open 
processing 










IEAVNPC8 


Virtual stor- 
age manage- 
ment RIM 











TPARTBLE 


ILRASRM2 
ASM open 


processing 





WAI 30 Ayradorg — speliayeyA] posuaor] 


«Ald Jo SPREE) PePUBsey,, 


L861 ‘7861 “op WI WsUAdeD @ f-00ZI-8ZAT 


uoneJedg Jo poy “Ss uOTIIa¢S 


L6I-S 


C C 


) 


Diagram 25. Auxiliary Storage Management Initialization, Part 1 (IEAVNP04/ILRASRIM) Part 4 of 4 


Extended Description Module Labe} 


ILRASRIM OPENCOMM 
ILRASRM2 OPEN 
ILRIMMSG 


7 —siInvokes ILRASRM2 to open the second data set named 

in the DSTBL, the common data set. If this is a cold 
or quick start, sets the ILROPSPL reset flag to indicate that 
if the page data set resides on a cached auxiliary storage sub- 
system, I|LRPREAD must reset the cache. Reset of the 
cached auxiliary storage subsystem that has a page data set 
causes a TPARTBLE flag (TPARTRAP) to be set to validate 
future warm starts until the system is sufficiently initialized 
to allow a warm start. |f an error occurs, issues an appro- 
priate message depending on the nature of the error resulting 
from the open processing, If no error occurs, continues with 
step 8. 


8 sf this is a cold stert, continues with step9, Otherwise, ILRASRIM RBLDPLPA 
restores the PLPA and EPLPA to their states in the 

previous IPL. Reads the quick start record (QSRCD) and 

extended quick start record (EQSRD) from the PLPA page 

data set. The QSRCD and EQSRD were built during the 

previous cold start. (See the extended descriptions for 


IEAVNPO5 and ILROSRIT.) 


Fills inthe CVTPLPAS, CVTPLPAE, and CVT VVMDI from 
the QSRCD. Fills in NVTONUCS, NVTONUCE, 
CVTEPLPS, and CVTEPLPE from the QESRD. 


Calls the virtual storage management (VSM) module, 
|EAVNPC8 (an entry point in |EAVNPO8), to initialize the 
page tables (PGTs) and external page tables (XPTs) for the 
existing PLPA and EPLPA. |EAVNPC8 receives from the 
ASM RIM the starting addresses and lengths of the PLPA 
and EPLPA. It calculates the number of segments that must 
be initialized and builds a PGT and an XPT for each segment 
containing PLPA or EPLPA pages. As [EAVNPC8 initializes 
each PGT and XPT, it initializes the corresponding SGT entry 
with the real address of the page table and turns off the 
segment-invalid bit. 


IEAVNPC8 


€xtended Description Module Label 


Upon return from IEAVNPC8,|LRASRIM uses the OQSRCD ILRASRIM 
and EQSRD maps of LSIDs to read the XQSRDs on the 
PLPA data set into storage. Each XQSRD contains maps 
of LSIDs for the PLPA and EPLPA pages on the PLPA 
data set. These LSIDs are used to restore the appropriate 
XPTLSIDs and turn on the valid bits in each XPT entry. 
The first reference toPLPA or EPLPA page causes a page-in 
from the slot indicated in the XPTE for that page. The 
PLPA and EPLPA are thus restored. If errors occur in this 
rebuilding process, issues an appropriate error message and 
forces a cold start. 


ILRIMMSG 


Qs Prepares for the end of the first ASM RIM. Deletes 

modules |LROPSOO, ILRPREAD, and IEAVNPC8. 
Saves these pointers and values in the TPART BLE for use 
by the second ASM RIM (IEAVNP14/ILRASRM1). Saves 
the pointer to the TPARTBLE in the ASMVT. 


Note: Errorsin ILRASRIM processing are handled by issuing 
messages that request the operator to specify or to allow 
alternative actions to take place. In some cases, messages 
are a notification of a problem and the action ASM takes 

to correct the problem. |f a major error occurs during 
|LRASRIM processing and there are no alternative actions 
possible, then the system is put into a wait state with codes 
X'O03C’, X‘060', X‘061’, or X‘063'. Inthis case, the operator 
must attempt to correct the problem (for example a bad 
pack or data set) and then re-IPL. 


Recovery Processing 


None. 
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Diagram 26. Auxiliary Storage Management Message Module (ILRIMMSG) Part 1 of 2 


iILRASRIM, ILRASRM1, 
ILRASRMZ, ILRQSRIT 


Process 


Register 1 


Parameter list 1 Find message subroutine 
address in the branch table. 


2 Build the message. 
3 Write the message. 


Return to 
caller 
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Diagram 26. Auxiliary Storage Management Message Module (ILRIMMSG) Part 2 of 2 
Extended Description Module Label 


ILRIMMSG contains and writes all ASM RIM messages to 
the operator. 


1 ~—_Loop through an internal branch table within ILRIMMSG 
ILRIMMSG tooking for a match to the input message 

id. When a match is found, invoke the internal subroutine 

that prepares the message. 


2 = ~Each of the internal subroutines builds the appropriate 
message content for the input message id. Build the 
message One line at a time. 


3 Use the |EAPMNIP NIP service routine to write out 
the messages. If a “W” type message is to be written, IEAPMNIP 
write the message first and then put the system into the 
proper wait state, setting the wait state code in the NVT 
(NVTFLWSC). If the message is not type "W"', write 
the entire message and then return to the caller. if the 
message that is being written needs a reply, use IEAPMNIP 
with the type=WTOR option. Check for a reply and repeat 
issuing the message until a valid reply is given. 


Extended Description Module Label 


If an “1”, “E’, or “"W" type message is to be written, write 
only the last line of the message. 


For the “W”’ type message, use the IEAPMNIP NIP service 
routine with the type=SWAIT option to write the message. 


Recovery Processing: 


None. 
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Diagram 27. Auxiliary Storage Management Open Processing (ILROPS0O0) Part 1 of 4 
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RPGEXP 
ILRPG Process 


Input 






Register 1 





Prepare the catalog 
locate parameter lists. 


Locate the swap or page 
data set in the catalog. 


Mount the data set. 
OSPL 


Data set 
name 





Determine the status of 
the CACHE. Reset if 
necessary. 



























ILRPREAD 


ASM special 








Output 


Cljuster parameter list 


Control internal 
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Diagram 27. Auxiliary Storage Management Open Processing (ILROPS00) Part 2 of 4 


Extended Description Module Label 
|LROPSOO opens a page or swap data set on behalf of the 

ASM RIM (ILRASRM2’s open service routine, called by 

ILRASRIM or ILRASRM1) during system initialization or 

on behalf of ASM’s page expansion processing (ILRPGEXP) 

after system initialization. 


1 ILROPSOO initializes the catalog locate parameter lists ILROPSOO LOCPREP 
and catalog field parameter lists in order to perform a 

cluster locate and data control interval location, respectively, 

to obtain VSAM catalog information. These locates will 

return information such as data set type, volume serial 

number, volume attributes, device types, the address of the 


catalog ACB, and statistical data from the VSAM catalog. 


2 For a page data set, |LROPSOO performs the cluster ILROPSOO LOCPAGE 
locate. If the cluster locate is successful, |LROPSOO 
issues a locate for the page data set’s volume serial number, 


device type, attributes, and AMDSB. 


If either the cluster locate fails or the second locate fails, 
ILROPSOO returns to the caller with an error return code 
of 12. 


For a swap data set, |LROPSOO performs the cluster locate. ILROPSOO LOCSWAP 
If the cluster locate is successful, |LROPSOO issues a locate 
for the swap data set’s volume serial number, device type, 


data set attributes, and AMDSB. 


If the cluster locate fails or the second locate fails, 
ILROPSOO returns to the caller with an error return code 
of 12. 


‘) 


Extended Description Module Label 
3  %ILROPSOO verifies that the page or swap data set is 

mounted and online. If |LROPSOO is being used during 
system initialization (that is, the caller is |LRASRIM), 
ILROPSOO uses the NIPMOUNT service routine to verify 
the mount status. If |LROPSOO is being used after system 
initialization (that is, the caller is ILRPGEXP), ILROPSOO 
uses dynamic allocation. If this mount verification is 
unsuccessful, |LROPSOO returns to the caller with an error 
return code of 8. 


ILROPSOO VMTVER 


4 siIf the data set is on a cached auxiliary storage 

subsystem, ILROPSOO calls ILRPREAD to find the 
cache element address. Then [LROPSOO performs one 
of the following: 


e If the cache element (CACE) indicates that the cache is 
bad and was in use, |LROPSOO cannot use the cache and 
the data set. Processing continues with step 8. 


@ If the cache is not in use and (1) a PAGEADD request is 
being processed, (2) this is a cold start, or (3) this is 
a quick start, |LROPSOO calls ILRPREAD to reset the 
cache. 


ILRPREAD 


e@ If the cache is not in use or this is a warm start, 
ILROPSOO calls ILRPREAD to test the cache. If the cache 
is bad and not in use (for warm starts only), [LROPSOO 
calls |LRPREAD a second time to reset the cache. 
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Diagram 27. Auxiliary Storage Management Open Processing (ILROPS00) Part 3 of 4 


Input 


5 Determine the type of 
path requested. 


Process 


@ Short path 
@ Long path 


6G Allocate the data set. 


7 Obtain storage for and 
build the control blocks. 


8 Send back a parameter 
list and return code, 






Return 
to caller 


Step 8 
Step 6 


Output 


PCCWs or SCCWs 


Register 1 


Register 15 


Reserved 

tORB address 
UCB address 
EDB adaress 
Number of slots 
Device type 
Volume serial no. 
SQA address 
SQA length 
CCHH begin 
CCHH end 
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No. of PCCWs or 
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Address of first 
PCCW or SCCW 


Address of chain 
field in last 
PCCW or SCCW 
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Diagram 27. Auxiliary Storage Management Open Processing (ILROPSOO) Part 4 of 4 


Extended Description Module Label 


5 «Two paths are possible through |LROPSOO: a short ILROPSOO GETCORE 
Path or a long path. The short path, requested in the 

flag settings of the input parameter list, is used during 

system initialization by ILRASRM1 (only for a warm start). 

With the short path, |LROPSOO returns to the caller (see 

step 8) at this point having successfully opened a page or 

swap data set. The short path is used to verify the avail- 

ability of ’*needed jocal’’ page data sets before contro! 

blocks are built. !f a “needed loca!’’ page data set is not 

available, the warm start fails. 


The long path, requested in the flag settings of the input 
parameter list, is by both |LRASRIM, |LRASRM1, and 

[{LRPGEXP to open a page or a swap data set and build 

the required ASM control blocks. Continues processing 
with step 6. 


Gg 'ILR OPS00 allocates the data set. If ILROPSOO is being 

used during system initialization (that is, that caller is 
ILRASRIM or ILRASRM1), ILROPSOO calls the dynamic 
allocation NIP service routine. If |LROPSOO is being used 
after system initialization (that is, the caller is |LRPGEXP), 
ILROPSOO sets UCBPRES to 1. The dynamic allocation call 
(in step 3) sets the other UCB bits for allocation. 


7 ‘If the UCB {and its associated control blocks) for the de- 
vice on which the data set resides indicates that ex- 
tended count, key, and data (ECKD) is allowed, |LROPSOO 
turns on the ECKD flag and puts the CCHH beginning and 
ending address in the output parameter list. |LROPSOO cal- 
culates the amount of extended SQA and nucleus buffer 
area required to build the |/O control blocks. |LROPSOO is- 
sues the GETMAIN macro instruction to obtain storage from 
subpool 245. If the GETMAIN is unsuccessful, [LROPSOO 
sets a return code of 16 (for SQA space not available). If the 
GETMAIN jis successful, |LROPSOO builds PCCWs if pro- 
cessing a page data set, or SCCWs if processing a swap data 
set, and builds the other |/O control blocks (IORB, EDB, 
[OSB, SRBs, LPMB) in SQA. 


ILROPSOO GETCORE 


Extended Description Module Label 


8 _ ‘!f processing in steps 1 thru 7 is successful, |LROPSOO {LROPSOO 
returns to the caller with a return code of zero and an 

initialized parameter list containing the open information for 

the page or swap data set. If processing in steps 1 thru 7 was 

unsuccessful, |LROPSOO returns to the caller with a nonzero 


return code. 


Recovery Processing 


None. 
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Diagram 28. Auxiliary Storage Management Special Read/Write (ILRPREAD) Part 1 of 6 


From ILRASRIM, ILROPSOO, ILRPGEXP, 
ILRQSRIT, ILRTMIOO 
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Diagram 28. Auxiliary Storage Management Special Read/Write (ILRPREAD) Part 2 of 6 


Extended Description Module Label Extended Description Label Module 


2 = fcontinued) 
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|LRPREAD is an I/O driver that reads and writes slots con- 
taining control blocks and other information that ASM needs 
either during system initialization or when page and swap 
data sets are added after initialization. ASM initialization 
reads and writes ILRTPARB (the TPARTBLE), the quick 
start record (QSRCD), the extended quick start record 
(EQSRD) and the quick start record extensions (XQSRDs) 
on the PLPA data set and record 0 time stamps on the 
common and duplex data sets. When page and swap data 
sets are added after initialization, ASM uses ILRPREAD to 
read and write the TPARTBLE. ASM needs this information 
for quick and warm starts. In order for ASM to use page 
and swap data sets defined on a cached auxiliary storage 
subsystem, ILRPREAD also obtains the address of the 
cache array element and tests or resets the cache as specified 
oninput. If reset is required after the cache has been tested 
or reset is requested, ILRPREAD reinitializes the directories 
and control information used by the cache. 


1 ‘Establishes an ESTAE environment for abnormal! 

termination, Note that the ESTAE routine gets con- 
trol only when page or swap data sets are added; it does 
not get contro! for abnormal termination during system 
initialization. 


2  'ILRPREAD determines the requested function by 
examining the request flag. The request flags also 
indicate which parameters contain valid information and 
the length of the channel program required to satisfy the 
request. The request flags and the valid parameters are: 


Significant Input Parameters 


Obtain 

slot for 

XQSRD 
Parameter Slots 


Request Flag ‘40'X 


Slot Count 


@ UCB 
@ EDB 
@ Data Area 


@ Cache Array 
Element 





3 $$ !LRPREAD obtains storage for an |OSB, an SRB, a 


save area for both control blocks, and for the 
channel program. 
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Diagram 28. Auxiliary Storage Management Special Read/Write (ILRPREAD) Part 3 of 6 


Input Process Output 
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@ Cache Array 6 Start the channel program and 1OSUCB 
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Diagram 28. Auxiliary Storage Management Special Read/Write (ILRPREAD) Part 4 of 6 


Extended Description 


4 = The address of normal end appendage, abnormal end 

appendage, and |/O termination are placed in the l|OSB. 
These routines are secondary entry points in |ILRPREAD. 
The address of the TCB and the ASID are also placed in the 
1OSB. Because the TCB and the ASCB are identified in the 
IOSB, RTM processing cleans up any ILRPREAD resources 
and outstanding i/O if errors occur in |OS or the ILRPREAD 
appendages. The IOSB also indicates whether the channel 
program requires an |OS-provided prefix and a specific 
deviceexposure. The SRB address is also placed in the |OSB, 
and the TCB address is placed in the SRB. 


F ~—sBuild the channel program that performs the function 
identified in step 2: 


@ Toread slots, the channel! program consists of one or 
more sets of the following CCW sequence: 


SEEK HEAD 
SEARCH ID EQUAL 
TIC 

READ DATA 


1OS supplies a prefix for the channel program. That is, 
IOS prefixes the channel program with CCWs. 


@ Towrite slots, the channel program consists of one or 
more of the following CCW sequence: 
SEEK HEAD 
SEARCH ID EQUAL 


Tic 
WRITE DATA 


1OS provides a prefix for the channel program. That is, 
1OS prefixes the channel program with CCWs: 


@ To test acache, the channel program consists of the fol- 
lowing CCW sequence: 


SENSE SUBSYSTEM STATUS 
NO-OPERATION 


1OS does not supply a prefix for the channel program. 


Module 


Label 


Extended Description Module Label 


5 (continued) 


e Toreset acache, the channel program consists of the 
fallawing CCW sequence: 


SET PAGING PARAMETERS 

DISCARD BLOCK 

1\OS does not supply a prefix for the channel program. 
@ Toobtainthe address of a cache array element, the chan- 

nel program consists of the following CCW sequence: 

SENSE SUBSYSTEM STATUS 

NO-OPERATION 


1OS does not supply a prefix for the channel program. 


6 Start the channel program and wait for it to complete. 

ILRPREAD uses the STARTIO macro instruction to 
pass the address of the SRB to IOS. Note the SRB addresses 
the |\OSB which in turn, points to the channel program. 
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Diagram 28. Auxiliary Storage Management Special Read/Write (ILRPREAD) Part 5 of 6 
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Cache Array 
Element 


CT 
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Diagram 28. Auxiliary Storage Management Special Read/Write (ILRPREAD) Part 60f 6 '‘°- 


Extended Description 


Module 


J Check the channel program completion status, When 
the channel program completes successfully, the com- 
pletion codes are as follows: 


Function 


Read slots 
Write slots 
Test cache 


Reset cache 


Obtain cache array 
entry address 


Action 


Return code = 0 

Return code = 0 

CACETEST = 1 

If cache is valid, CACEBAD = 0 
and the return code = 0 

If cache is invalid, CACEBAD = 1 
and the return code = 8 


If cache is valid but not in use, CACEUSE = 1 


CACETEST = 1 
CACERSET = 1 
CACEBAD =0 
CACEUSE = 1 


Return code = 0 
Calculate cache array entry address 
Return code = 0 


When the channel program completes unsuccessfully, the 
completion codes are as follows: 


Function 


Read slots 
Write slots 
Test cache 


Reset cache 


Obtain cache array 
entry address 


Action 


Return code = 8 
Return code = 8 
CACETEST = 1 
CACEBAD = 1 

Return code = 8 
CACETEST = 1 
CACEBAD = 1 

Return code = 8 
Return code = 8 


Labet 


Extended Description 


8 (iLRPREAD frees the storage it previously acquired to 
execute the channel program. 


9 ILRPREAD cancels the ESTAE environment. 


10 (ILRPREAD returns to its caller the address of the 
parameter list in register 1 and the return code in 
register 15. 


Recovery Processing 

The ESTAE routine frees the siorage ILRPREAD acquired 
to execute the channel program, sets a return code = 0, and 
requests percolation. 

Normal End Appendage 


Returns to the caller. 


Abnormal End Appendage 


Returns to the caller. 


1/O Termination Routine 


Notifies ILRPREAD (Step 7) that the IOS interface has 
completed and releases the local lock 1OS obtained to 
build the channel programs (Step 5). 


Module 


ILRPREAD 


ILRPREAD 


ILRPREAD 


ILRPREAD 


) 


Label 


ESTAEXIT 


PREADNRM 


PREADABN 


PREADTRM 
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Diagram 29. SQA Parameter Initialization (IEAVNPAS8) Part 1 of 6 


IEAVNIPM 


(Step 15) 


Input Process 








1 Determine the size of 
additional SQA and ESQA. 


NVT 


NVTFLOS 





a. Validate the SQA 


CVTPLPAE parameter syntax. 


CVTEPLPS 






b. For quick and warm 
start initialization, 
use existing SOA and 
ESQA size. 


CVTGDA 





sr 
GDASOQA 


GDAESQA 


GDAESQAS 


GDAPV TSZ 
——— 












c. Forcold start initiali- 
zation, use values 
specified on the SQA 
Parameter or the 
default values. 








2 Serialize the VSM queues 
and workarea. 


CVTGDA 







3 Build VSM control 
blocks for additional non- 


GDAAQATS6 extended SOA storage. 






a. Build AQATSs for 
subpools 226, 239 
and 245. 


GDAAQATS 






GDAAQATS5 





Output 


es 
AQATINDX 


AQATID 
ee 
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Diagram 29. SQA Parameter Initialization (IEAVNPAS8) Part 2 of 6 


Extended Description Module Label 


IEAVNIPM calls the virtual storage management (VSM) RIM, 
IEAVNPAS, to process the SQA system parameter and build 
the VSM control blocks and page tables necessary to describe 
the additional system queue area (SQA) and extended SQA 
(ESQA). The form of the parameter is SQA=(a, b), where ‘a’ 
and ‘b’ are values that are multiplied by G4K to determine 
the amount of storage to be added to SQA and ESOQA 
respectively, The VSM RIM adds the requested amount of 
SOA storage to the storage that IEAIPLO4 allocated. When 
this RIM gets control, there is 192K of non-extended SQA 
storage and 192K + 8Mb of extended SQA storage. (IEAIPLO4 
allocated the 8Mb for common area page tables, therefore 
this area is not available for allocation in response to 
GETMAINSs.) 


1 The VSM RIM checks NVTFLQs to determine if the IEAVNPAS IEAVNPAS8 
initialization in progress is a quick start and validates 


the SQA parameter. 


a. The VSM RIM validates the SQA parameter syntax and 
parses the parameter to obtain the ‘a’ and ‘b’ values. 


b. If a quick or warm start is in process, the size of the SOA 
is determined by the start address of the initial SQA 
(GDASQOA) and the end address of the PLPA (CVTPLPAE). 
The size of the ESQA is determined by the end address 
of the ESQA (GDAESQA + GDAESQAS) and the start 
address of the extended PLPA (CVTEPLPS). If the 
operator specified an alternate nucleus or specified an ‘a’ 
or ‘b‘ value different from the values that existed from a 
previous cold start, the VSM RIM issues message 1EA908I 
to inform the operator that it is ignoring the keyword. 
The message also states the size values the RIM is using 
for the SQA and ESQA. 


Extended Description 


c. If acold start is in process, and the syntax is invalid, the 


a. The RIM issues a GETMAIN macro instruction to obtain 


ra 


Module Label 


VALIDATE 
RIM issues message IEA3211. This message informs the 

operator that the syntax is invalid and prompts the 

operator for new values. If the operator does not specify 

‘a’ and ‘b’ values, or if the parameter is omitted, the VSM 

RIM uses the default values SQA=(1, 0). 


If the operator specified a size value that caused the SQA . 
or ESQA to overlap into NIP’s private area, the RIM 

issues message IEAQOS9I to inform the operator that the 
value is too large. The RIM also prompts the operator 

for new values. 


2 ‘The VSM RIM issues a SETLOCK macro instruction to IEAVNPAS 


obtain the LOCAL and VSMFIX locks. These locks 


serialize access to the VSM queues and the VSM workarea 


(VSWK). 


3 ‘The VSM RIM initializes VSM control blocks for the 


new non-extended SQA storage. 


BUILDAQT 
storage in the SQA for the AQATs that describe subpools 

226, 239, and 245, It zeros the AQATs, sets the AQAT 

index table entries (AQATINDX) to point to the appro- 

priate AQAT, and initializes the control block ID fields 

(AQATID). 
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Diagram 29. SQA Parameter Initialization (IEAVNPAS) Part 3 of 6 


Input Process Output 



















3 (continued) 


b. Turn on AQAT allo- 
cation bits for sub- 
pool 245. 






IGVAAQAT 


Turn allocation 
bit on 











AQATALOC 





c. Build page tables for 
new SQA storage. 









IARVB-RSM 


CVT 
CVTGDA CVTGDA 


Build page 
table 








GDASOQA 


GDACSA 


GDASOQASZ 


GDASOQASZ 





d. Adjust fields in 
GDA. 
























. Build DFE and place 
it on subpool 245 DFE 
queue. 
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Diagram 29. SQA Parameter Initialization (IEAVNPAS8) Part 4 of 6 


Extended Description Module Label 


3. (continued) 


b. The RIM calls |GVAAQAT to turn on the AQAT alloca- IGVAAQAT 
tion bits for subpool 245. These bits indicate that the 
storage is part of subpool 245 and that it is available for 
use. Note that the allocation bits for subpools 226 and 
239 are not turned on in this module. When a system 
component issues a GETMAIN macro instruction for 
storage in these subpools, VSM will obtain storage for 
the requested subpool from subpool! 245 and turn on the 
corresponding AQAT bits. 


c. For each new segment of SQA storage, the VSM RIM IARVB IARVBCSG 
calls RSM module I[ARVB to build a page table. If 
there is not enough real storage available for a page table, 
the VSM RIM issues message IEA9O7W to inform the IEAVNPA8 
operator that it cannot initialize the page tables for the 
SQA. It then places the system in a wait state with a 
wait state code of X’03D’. 


d. The VSM RIM adjusts fields in the GDA to reflect the 
change in the SQA. 


e, The RIM issues a branch enty FREEMAIN macro in- 
struction, which causes a double free element (DFE) to 
be built and enqueued on the non-extended subpooi 
245 queue. 
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Diagram 29. SQA Parameter Initialization (IEAVNPAS) Part 5 of 6 


Input Process Output 






CVT 


CVTGDA 






4 Build VSM control biocks 
for additional extended 
SOA storage. 










Sd 
AQATINDX 






















a. Build AQATSs for 
subpools 226, 239, 
and 245. 


. Turn on AQAT allo- 
cation bits for sub- 
pool 245. 


GDAAQATS 






GDAAQAT5 






IGVAAQAT-VSM 






Turn allocation 
bits on 












. Build page tables for 
new ESQA storage. 







IARVB-RSM 






Build page 
table 





CVTGDA 






. Adjust fields in GDA. 











. Build DFE. 





CC 
GDAESQAS 












5 Free locks used to 
serialize the VSM queues 
and workarea and return. 






GDAECSA 
——————— 






To IEAVNIPM 





e c ad 
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Diagram 29. SQA Parameter Initialization (IEAVNPAS8) Part 6 of 6 
Extended Description Module 


4 The VSM RIM builds control blocks for the additional 
ESOA storage. To avoid using up the entire 

amount of initial SQA to build AQATs to describe the 

ESOA, the RIM repeats the following steps for each 8-mega- 

byte block of requested ESQA storage. 


a. The RIM issues a GETMAIN macro instruction to obtain 
storage in the ESOA for the AQATs that describe sub- 
pools 226, 239, and 245. It zeroes the AQATS, sets the 
AQAT index table entries (AQATINDX) to point to the 
appropriate AQAT, and initializes the control block ID 
fields (AQATID). 


b. The RIM calls IGVAAQAT to turn on the AQAT alloca- IGVTAAQA 
tion bits for subpool 245. These bits indicate that the 
storage is part of extended subpool] 245 and that it is 
available for use. Note that the allocation bits for sub- 
pool 239 is not turned on in this module. When a system 
component issues a GETMAIN macro instruction for 
storage in this subpool, VSM will obtain storage for the 
requested subpool from subpool 245 and turn on the 
corresponding AOAT bit. 


c. For each new segment of ESQA storage, the VSM RIM IARVB 
calls RSM module IARVB to build a page table. If there 
is nOt enough real storage available for a page table, the 
VSM RIM issues message |EAQO07W to inform the oper- \EAVNPAS 
ator that it cannot initialize the page tables for the ESQA. 
it then places the system in a wait state with a wait state 
code of X‘03D’. 


d. The VSM RIM adjusts fields in the GDA to reflect the IEAVNPAS& 
change in the ESQA areas. 


e. The RIM issues a branch entry FREEMAIN macro in- 
struction, which causes a double free element (DFE) to 
be built and enqueued on the extended subpool 245 
queue. 


& The VSM RIM issues a SETLOCK macro instruction 
to free the LOCAL and VSMFIX locks and returns 
control to IEAVNIPM. 


Label 


BUILDAQT 


IARVBCSG 


IEAVNPAS8 
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Diagram 30. Auxiliary Storage Management Initialization, Part 2 (IEAVNP14/ILRASRM1) Part 1 of 6 


Input 


Register 2 


ee 
NVTPTAB 


TPART BLE 


JEAVNIPM 
(Step 16) 


Process 


J Load modules [LROPSOO and 
[LRPREAD. 


2 Set pointers to the ASM 
control blocks. 


3 ~Parse the NONVIO parameter. 


{|LRASRM2 


Parse data 


set names 





Output 


TPARTBLE 


[| 


DSTBL 


[| 


XQSRD 


[| 


TPARTBLE 


[| | 
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Diagram 30. Auxiliary Storage Management Initialization, Part 2 (IEAVNP14/ILRASRM1) Part 2 of 6 


Extended Description 


ILRASRM1 builds and initializes ASM control blocks and 
Opens the page data sets and swap data sets. LEAVNIPM 
enters ILRASRM1 during NIP processing. ILRASRM1’s 
normal exit is to IEAVNIPM. 


IEAVNIPM calls ILRASRM1 for cold, warm, and quick 
starts. Unless otherwise specified, the processing is the 
same for all three types or starts. 


Note that IEAVNIPM knows ILRASRM2 as IEAVNIP14. 
ILRASRM1 is the entry point in the load module 
IEAVNP14, 


1 |LRASRM1 loads |LROPSOO and ILRPREAD. 
|LROPSOO and ILRPREAD are required to open, 
read, and write to the page and swap data sets. 


2 ILRASRM1 obtains addressability to the TPARTBLE; 
and restores the following control block pointers in 
the TPARTBLE: 


@ the quick start record (QSRCD) 
e@ the extended quick start record (EQRSD) 


e@ the work area for the quick start record extension 
(XQSRD) 


@ thedevice table (DVTAB) 
@ the cache array table (CACHE) 


@ a data set work area (DSTBL) 


3  |ILRASRM1 uses the parameters in PARMTAB to 
locate and parse the NONVIO data set name string 
and mark the specified data sets as NON VIO in the DSTBL 
or the TPARTBLE. |ILRASRM(1 calls the parse routine in 
ILRASRMZ2 to parse the NONVIO data set name list. 


Module Label 


ILRASRM1 RIMINIT 


ILRASRM1 NOVIOCHK 


ILRASRM2 PARSE 
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Diagram 30. Auxiliary Storage Management Initialization, Part 2 (IEAVNP14/ILRASRM1) Part 3 of 6 


Input Process Output 


TPARTBLE 
4 Open the local paging data 


sets. 


ILRASRM2 


ASM open 
processing 


odo] Wu] wWaIsks VX/SAN QI7-S 


Put the timestamp in the 
TPARTBLE, the OSRCD, the 


EQSRD, and the two paging Common m 

data sets (duplex and com- 
data set 

mon) for a cold start. 


Duplex paging 
data set 
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Diagram 30. Auxiliary Storage Management Initialization, Part 2 (IEAVNP14/ILRASRM1}) Part 4 of 6 


Extended Description 


4 Onawarm start, there are local page data sets con- 

taining V!O pages that are identified in the 
TPARTBLE. These VIO pages are usable. Open the local 
page data sets containing these V|O pages. If any of these 
local data sets are not usable, the warm start will fail. The 
IPL will continue as a quick start provided that the operator 
does not choose to re-IPL. Ignore the NONVIO local data 
sets during this processing. At this point in the IPL, a 
NONVIO local data set is not considered to be a required 
local data set for warm start even if it contains V!O pages. 
After the local page data sets identified in the TPARTBLE 
are processed, open the local page data sets listed in the 
DSTBL. If this is a cold or quick start, set the |LROPSPL 
reset flag to indicate that if the page data set resides on a 
cached auxiliary storage subsystem, |LRPREAD must 
reset the cache. Reset of the cached auxiliary storage 
subsystem that has a page data set causes a TPAR TBLE 
flag (TPARTRAP) to be set to invalidate future warm 
starts until the system is sufficiently initialized to allow a 
warm start. 


lf errors occur for the open processing, issue an appro- 
priate message depending on the nature of the error. 
Otherwise, continue with step 5. 


5 Verify on a quick or warm start that the correct level 

of QSRCD, EQSRD, and TPARTBLE are being used. 
Also, verify that the data sets containing PLPA (that is, 
the PLPA data set, the common data set, and the duplex 
data set) are at the correct level. Continue with step 6. If 
this is a cold start, put a timestamp in the QSRCD and 
TPARTBLE, and PLPA and common page data sets. 
Continue with step 6. 


Module Label! 


ILRASRM1 NEEDLOCL 


ILRASRM2 OPEN 


ILRASRM1 OPENLOCL 


ILRASRM2 OPEN 


ILRIMMSG 


ILRASRM1 TIMESTMP 


|1LRPREAD 
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Diagram 30. Auxiliary Storage Management Initialization, Part 2 IEAVNP14/ILRASRM1) Part 5 of 6 


Input 


TPART BLE 


= 


VT 


NVTPTAB 


Work flags 


List flag='1’ 


O 
“”n 
= 
ow 
a 


PRDPL 


[| 


PARMTAB 


Process 


10 


11 


12 


Output 


ASMVT PART 


Build the PART nempant [Lb 


ILRPREAD 


PLPA 


Write the TPARTBLE to data sets 


the PLPA data set. TPARTBLE 


Kt 


Special read/ 
write routine DSTBL 





Obtain the swap parameter 
data. 


SART 


> 
w 
< 
4 


Open the swap data sets ASMSART 


and fillin the SART. 


GVT 
Build the logical group L 


vector table (LGYT). 


Build the message buffers. Message buffers 


Build the ASM cell pools. 


List the names of the page 
and swap data sets. 


Console listing 





IEAVNIPM 





e L 
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Diagram 30. Auxiliary Storage Management Initialization, Part 2 (IEAVNP14/ILRASRM1) Part 6 of 6 


Extended Description 


G6 Use the TPARTBLE, now complete with information 
about the paging data sets opened for this IPL, and 
build the paging activity reference table (PART). 


7 —slf this is a quick or warm start, issue the FREEMAIN 

macro instruction to free the QGRCD, EQSRD, and 
XQSRD. Do not free the TPARTBLE, but write the 
TPARTBLE to the PLPA data set. If this is a cold start, 
the NIP module, IEAVNPOS5 will call |LROQSRIT tater in 
the IPL. ILRQSRIT will fill in the QORCD, EQSRD, and 
XQSRDs, write the QSRCD, EQSRD, and XQSRDs, and 
TPART BLE to the PLPA data set, and then free the 
QSRCD, EQSRD, and XQSRAD storage. 


The TPARTBLE is freed during master scheduler initial- 
ization by ILRTMIOO. 


8 Use the parameter data in PARMTAB to locate the 
swap parameter data. Initialize the swap data set 
names in the DSTBL. 


Q  Usingthe DSTBL, invoke ILROPSOO to open the swap 
data sets. Put information about the opened data 
sets in the swap activity reference table (SART). 


10 Clear the area used for the DSTBL and ILRPREAD 

buffer areas and reuse it for the logical group vector 
table (LGVT). ASM uses the LGVT to locate VIO data. 
After the LGVT is initialized, delete modules |LROPSOO, 
ILRPREAD, and ILRDVTBL, using the DELETE macro 
Instruction. 


Module Label 


ILRASRM1 BLDPART 


QSRTPARB 


ILRPREAD 


ILRQSRIT 


ILRASRM1) INITSART 
ILRASRM2 PARSE 


OPENSWAP 
ILRASRM2 OPEN 


[ILRASRM1 LGVTSRB 


Extended Description Module Labe! 


11. Build the message buffers used by the ASM message MSG BUF 
module, |LRMSGOO. ILRMSGOO gets control during 


normal system operation (that is, after an IPL). 


12 Obtain storage for ASM cell pools. ASM cell pools BLDCELLS 
are pools of control blocks used by ASM. Having pools 

of storage available removes the overhead of performing 

GETMAINSs during its processing. The cell pools are for 


ASM control elements (ACEs) and work areas (BWKs). 


13 Ifthe PAGE=(..., L) parameter was used to request 
a listing of the paging and swap data sets or if any data 

set changes occurred during ILRASRIM or ILRASRM1 

processing, list the names of the page and swap data sets. 


LISTMSG 
ILRIMMSG 


Note: Errors in |ILRASRM1 processing are handled by 
issuing messages that request the operator to specify or 
to allow alternative actions to take place. In some cases, 
messages are a notification of a problem and the action 
ASM takes to correct the problem. If a major error 
occurs during |LRASRM1 processing and there are no 
alternative actions possible, then the system is put into a 
wait state with codes X’03C’, X’061', or X‘063’. In this 
case, the operator must attempt to correct the problem 
(for example a bad pack or data set) and then re-IPL. 


Recovery Processing: 


None. 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 1 of 23 
IEAVNP25 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: SVC PARMLIB Processing RIM 


FUNCTION: 

The SVC Table RIM is called by IEAVNIPM to Process SVCPARM 
Statements from IEASVCxx members in SYS1.PARMLIB. For PARMLIB 
processing, IEAVNP25 uses the General Parmlib Scan Routine 
(IEEMB888) to read PARMLIB based on the “SVC=" specification. 
IEEMB888 builds a logical record to pass to the Statement 
Processor routine (IEAVNS25 entry point in IEAVNP25). 

IEAVNS25 uses the Generalized Parser (IEEMB887) to parse the 
logical record. JIEAVYNP25 builds an entry in the SVC Table 
Work Area (SVCTWA) for each valid SVCPARM statement. If there 
is an invalid SVC= specification, the operator will be 
prompted via NIPPROMPT and PARMLIB processing will be 
re-initiated. 2D1C Mainline processing continues after all SVC 
PARM statements have been read and parsed. JIEAVNP25 scans the 
SVC Table Work Area (SVCTWA). For nucleus-resident SVCs (Type 
1, 2 & 6), the SVC Table is updated using the SVC Dynamic 
Update Routine (IEAVESTU). For LPA-resident SVCs (Type 3 & 4); 
IEAVNPS5 will update the SVC Table based on data saved in the 
SVCTWA. 


ENTRY POINT: IEAVNP25 

PURPOSE: 
This is the main entry point to the module. 
See OPERATION Section. 

LINKAGE: BASSM R14,R15 

CALLERS: IEAVNIPM 

INPUT: 


- NIP Parameter Address Table referenced by NVTPTAB 
- NIP Parameter Area Header (IEAPPNIP ) 


OUTPUT: 
- NUCLEUS-RESIDENT - SVC Table updated. 
- LPA-RESIDENT - SVC Table Workarea (SVCTWA) contains 


entry point names and attributes. IEAVNPS5 will use 
SVCTWA to update SVC Table after LPA is initialized. 


EXIT NORMAL: Return to IJEAVNIPM 

ENTRY POINT: IEAVNS25 

PURPOSE : 
This entry point is responsible for verifying and processing 
individual SVCPARM statements read from SYS1.PARMLIB members 
by the General Parmlib Scan Routine CIEEMB8S8). This routine 
manages the interface to the Generalized Parser (IEEMB&87) 

LINKAGE: BASSM R14,R15 

CALLERS: IEEMB88&& 


INPUT: 


Statement Processor List (JEEZB821) 

A logical SVCPARM statement pointed to by the 
Statement Processor List 

The SVC Table referenced by SCVTSVCT 

The SVC Table Work Area pointed to by NVTSVCN 


- Scan Parameter List (SCL) 

- Character string for Keyword processed by Parser 
pointed to by Scan Parameter List. 

- Workarea (with ‘footprints’ ) 
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| Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 2 of 23 
Cc IEAVNP25 - MODULE DESCRIPTION (Continued) 


- The SVC Table Work Area 
OUTPUT: 
- SVC Table Work Area containing entry point names 
and attributes of user SVCs 
EXIT NORMAL: Return to IEEMB888 
EXIT ERROR: Return to IEEMB888 
OUTPUT: - Workarea ‘footprints' set 
ENTRY POINT: SVCSEM 
PURPOSE: Parser Exit Routine for processing <SVCNUM> SVCPARM token. 
LINKAGE: None 
CALLERS: None 
INPUT: None 
OUTPUT: None 
ENTRY POINT: REPSEM 
PURPOSE: Parser Exit Routines for processing <REPLACE> SVCPARM token 
LINKAGE: None 
CALLERS: None 
INPUT: None 
OUTPUT: None 
ENTRY POINT: EPNSEM 
PURPOSE: Parser Exit Routines for processing <EPNAME> SVCPARM token 
LINKAGE: None 
CALLERS: None 
INPUT: None 
OUTPUT: None 
ENTRY POINT: TYPESEM 
PURPOSE: Parser Exit Routines for processing <TYPE> SVCPARM token 
LINKAGE: None 
CALLERS: None 
INPUT: None 
OUTPUT: None 
ENTRY POINT: APFSEM 
PURPOSE: Parser Exit Routines for processing <APF> SVCPARM token 


( LINKAGE: None 


CALLERS: None 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 3 of 23 
ITEAVNP25 - MODULE DESCRIPTION (Continued) 


INPUT: None 

OUTPUT: None 
ENTRY POINT: LOCKSSEM 

PURPOSE: Parser Exit Routine for processing <LOCKS> SVCPARM token 
LINKAGE: None 

CALLERS: None 

INPUT: None 

OUTPUT: None 
ENTRY POINT: LOCKISEM 

PURPOSE: Parser Exit Routine for processing a single lock token 
LINKAGE: None 

CALLERS: None 

INPUT: None 

OUTPUT: None 
ENTRY POINT: NPSEM 

PURPOSE: Parser Exit Routines for processing <NPRMPT> SVCPARM token 
LINKAGE: None 

CALLERS: None 

INPUT: None 

OUTPUT: None 
ENTRY POINT: LPAREN 

PURPOSE ; 

Parser Exit Routine to setup detection of unbalanced 
parenthesis syntax error 

LINKAGE: None 

CALLERS: None 

INPUT: None 

OUTPUT: None 

ENTRY POINT: UNBCHEK 

PURPOSE : 

Parser Exit Routine for detecting unbalanced parenthesis 
syntax error 

LINKAGE: None 

CALLERS: None 

INPUT: None 


OUTPUT: None 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 4 of 23 
IEAVNP25 - MODULE DESCRIPTION (Continued) 


EXTERNAL REFERENCES: 


ROUTINES: 
IEAVESTU - Dynamic SVC Update Service Routine 
IEEMB888 - General Parmlib Scan Routine 
IEEMB887 - Generalized Parser 


DATA AREAS: 
FOR ALL ROUTINES: 
SVC Table Work Area (IHASVCT } -(cow) 


Passed by IEAVNP25 to IEEMB888: 
General Parmlib Scanner Parameter List (IEEZB819) -(c)w) 


Passed by IEEMB888 to IEAVNS25: 
Statement Processor List (IEEZB821) -(r) 


Passed by IEAVNS25 to IEEMB887 
Scan Parameter List (IEEZB815) -(c,w) 


Passed by IEEMB887 to each Semantic Exit Routine: 
Scan Parameter List (IEEZB815) -(ryw) 


CONTROL BLOCKS: 
CVT (Communication Vector Table) 
NVT (NIP Vector Table) 
IEAPPNIP (NIP Parameter Header Block ) 
SCVT (Secondary CVT) 


TABLES: 

Parse Table (IEEPARSE ) 

SVCTABLE - (row) 
SVC Update Recording Table - (w) 


SERIALIZATION: NIP RIM 


(r) 
(row) 
(ry w) 
(r) 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 5 of 23 
IEAVNP25 - MODULE OPERATION 





ITEAVNP25 - SVC PARMLIB processing RIM 


Obtain the SVC cpacification SVC=(xx,yy..,L) parameter from 
‘TEAPPNIP' If there is no SVC specification, return to NIPM. 


Obtain storage for the SVC Table work area, (SVCTWA) and store 
its address into NVTSVCN in the NIP Vector Table. Load the 
General Parmlib Scan Routine (IEEMB888) and the Generalized 
Parser (IEEMB887). 


Iniiialize the input areas (mapped by IEEZB819) for the 
General Parmlib Scan Routine (IEEMB888): 


- General Parmlib Scanner Parameter List defines the 
SYS1.PARMLIB member(s) to be processed. Also if 
the list option has been requested in response to 
“SPECIFY SYSTEM PARAMETERS", set a bit to indicate 
SVCPARM statements are to be logged. 

~- Statement Type Table defines IEAVNS25 as the Statement 

Processor routine for SVCPARM statements 


Call IEEMB888 to process SYS1.PARMLIB members. If the return 
code from IEEMB888 indicates a bad SVC= specification, issue 
an appropriate message (See MESSAGES section). For this error 
situaiion, prompt the operator to respecify the member suffix 
value(s) or to enter EOB. If the operator enters E0B, then 
free the SVCTWA, clear NVTSVCN, delete IEEMB888 and IEEMB887, 
and retur.. to NIPM. The IBM supplied default SVC Table is 
used. If the operator specifies values for SVC=, then ) 





reinitialize the General Parmlib Scanner Parameter List and 
call IEEMB888. 


When all PARMLIB processing is completa and all SVCPARM 
statements are valid, IEAVNP25 will scan through the SVC Table 
Work Area. For Type 1, 2 and 6 (nucleus-resident} SVCs, the 
SVC Dynamic Update Routine (IEAVESTU) will be invoked to 
update the SVC Table Entry. Type 3 or 4 (LPA-resident) SVCs 
requests will be counted. 


If the count is zero indicating no Type 3 or Type 4 SVCs, 
then free the SVCTWA and clear NVTSVCN, otherwise 
leave the SVCTWA for IEAVNPSS5 to process. 


IEEMB888 - General Parmlib Scan Routine 


IEEMB888 will open each PARMLI8 member and read records. 
IEEMB888 will handle any I/O errors or invalid statement 
types. It will call the Statement Processor routine (IEAVNS25) 
with a processing type indicator. 

For "STMT" type, a logical record is built and passed via 

the Statement Processor List (IEEZB821). 

For "EOP" type, the Statement Processor routine is invoked for 
final processing and error checking. 


IEAVNS25 ~ SVCPARM Statement Processor Routine 


If the call is for End-of~Parmlib (EOP) processing, return to 
IEEMB888 with a return code of zero. 


If the call is to process a logical SVCPARM statement, 
initialize the Scan Parameter List (IEEZB815) and call 
the Generalized Parser (IEEMB887). If the parser suffers 
an error, a message will be issued to the operator. 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 6 of 23 
IEAVNP25 - MODULE OPERATION (Continued) 


The Scan Parameter List and the Parse Table (built 

via the IEEPARSE macro), controls the processing of 

IEEMB887. As the parser processes the SVCPARM statement, exit 
routines will be called as specified on the ROUT options of 
the IEEPARSE macro. Footprints will be set as each Keyword 
1s parsed. When a match is found, routines will check for: 


--Required keywords. 
--Duplicate keywords. 
--Invalid specifications. 
--Inconsistent options. 
--A general syntax error. 


In addition to validity checking these same exit routines 
will perform necessary intermediate processing to: 


- Convert the specified SVC number to binary and build 
a default entry point name. 

- Convert SVC attribute specifications (TYPE, LOCKS, etc.) 
into an appropriate bit string. 

- Obtain a specified EPNAME. 


Syntactically correct duplicate statements are ignored, with 
an appropriate informational message issued. Invalid 
statements and statements with inconsistent specifications 
result in an appropriate message being issued and in the 
operator being prompted to respecify SVC= parameters. 

In all cases, processing of the IEASVCxx member continues. 


For Type 1,2, and 6 (nucleus-resident) SVCs, the nucleus 
lookup routine will be invoked via NUCLKUP to find the entry 
point address. If the entry point is not found, a 

message will be issued. 


For all correct SVCPARM statements, the entry point name, SVC 
attributes, and IEASVCxx suffix will be stored into the SVC 
Table Work Area. 


For all invalid Statements, a footprint will be set to 
control End-of-Parmlib processing. 


RECOVERY OPERATION: None. At NIP time recovery services are unavailable. 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 7 of 23 
IEAVNP25 - DIAGNOSTIC AIDS 





ENTRY POINT NAMES: IEAVNP25 
ITEAVNS25 
SVCSEM 
REPSEM 
EPNSEM 
TYPESEM 
APFSEM 
LOCKSSEM 
LOCKISEM 
NPSEM 
LPAREN 
UNBCHEK 


MESSAGES: 


THIS MODULE HAS RESERVED THE MESSAGES IEA821 - IEA835 


THE FOLLOWING INSERTS WILL BE REPLACED WITH: 
°"&&&&&' WITH A PASSED PARAMETER 
"seeseet! WITH THE CURRENT RECORD NUMBER BEING WORKED ON 
"2 '" WITH THE SVC NUMBER SPECIFIED 
'e¢ " WITH THE PARMLIB MEMBER CURRENTLY OPEN 
'¢ " WITH THE SVC TYPE SPECIFIED 


IEA821I 
ITEA823I 
TEA8241 
ITEA825I1 
IEA826I1 
IEA828I 
IEA830I 
IEA832I 
ITEA833I1 


SYNTAX ERROR IN 


ITEASVC¢¢; 
IEASVC¢¢: 
ITEASVC¢¢: 
IEASVC¢¢: 
IEASVC¢E¢: 
IEASVC¢¢: 
IEASVC¢¢: 
ITEASVC¢¢: 


“SVC="" PARAMETER 

SVC 4 : SYNTAX ERROR=&&&&&&&&, 

SVC “4 : DUPLICATE &&&&&&&& KEYWORD. 

SVC 4 : NO VALID &8&8&&&&&&8&82&&&% SPECIFICATION. 
SVC % : TYPE @ ROUTINE &&&&&&&& NOT FOUND. 
PARSE ERROR, STATEMENT 23238. 

DUPLICATE UPDATES TO SVC “4 IGNORED. 

SVC 24 : &&&&&&&& IS NOT A VALID &&8&&%&&&&. 
STATEMENT 38%: “% IS NOT A VALID SVCNUM,. 





ABEND CODES: None 


WAIT STATE CODES: 


RETURN CODES: 
ENTRY POINT IEAVNP25: 
EXIT NORMAL: 
0 
ENTRY POINT IEAVNS25: 
EXIT NORMAL: 
O = SVCPARM Statement is valid 
EXIT ERROR: 
20 = SVCPARM Statement is invalid 
ENTRY POINT SVCSEM: None 
ENTRY POINT REPSEM: None 


ENTRY POINT EPNSEM: None 
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Diagram 31. SVC PARMLIB Processing (EAVNP25) Part 8 of 23 


ITEAVNP25 =- DIAGNOSTIC AIDS (Continued) 


ENTRY POINT TYPESEM: None 
ENTRY POINT APFSEM: None 
ENTRY POINT LOCKSSEM: None 
ENTRY POINT LOCKISEM: None 
ENTRY POINT NPSEM: None 
ENTRY POINT LPAREN: None 


ENTRY POINT UNBCHEK: None 


REGISTER CONTENTS ON ENTRY: 
ENTRY POINT IEAVNP25: 


2 NVT 

3 CVT 
13 Address of 18 word save area 
14 =Return Address 
15 Entry Point Address 


ENTRY POINT IEAVNS25; 


1 Address of a word which contains the address 
of the Statement Processor List (IEEZB821) 


13. Address of 18 word save area 

14 Return Address 

15 Entry Point Address 
ENTRY POINT SVCSEM: Irrelevant 
ENTRY POINT REPSEM: Irrelevant 
ENTRY POINT EPNSEM: Irrelevant 
ENTRY POINT TYPESEM: Irrelevant 
ENTRY POINT APFSEM: Irrelevant 
ENTRY POINT LOCKSSEM: Irrelevant 
ENTRY POINT LOCK1SEM: Irrelevant 
ENTRY POINT NPSEM: Irrelevant 
ENTRY POINT LPAREN: Irrelevant 


ENTRY POINT UNBCHEK: Irrelevant 


REGISTER CONTENTS ON EXIT: 
ENTRY POINT IEAVNP25: 
EXIT NORMAL: 
0-13 Unchanged 
14 Return Address 
15 Zero 
ENTRY POINT IEAVNS25: 


EXIT NORMAL : 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 9 of 23 
ITEAVNP25 - DIAGNOSTIC AIDS (Continued) 





0-13 Unchanged 
14 Return Address 
15 zero 
EXIT ERROR: 
0-13 Unchanged 
14 Return Address 
15 zero 
THE FOLLOWING ENTRY POINTS ARE INVOKED AS EXIT ROUTINES 
BY THE GENERALIZED PARSER ( 'IEEMB887' ) 
EACH EXIT ROUTINE WILL GET CONTROL AS FOLLOWS: 
ENTRY POINT SVCSEM: Irrelevant 
ENTRY POINT REPSEM: Irrelevant 
ENTRY POINT EPNSEM: Irrelevant 
ENTRY POINT TYPESEM: Irrelevant 
ENTRY POINT APFSEM: Irrelevant 
ENTRY POINT LOCKSSEM: Irrelevant 
ENTRY POINT LOCK1SEM: Irrelevant 
ENTRY POINT NPSEM: Irrelevant 


ENTRY POINT LPAREN: Irrelevant 





ENTRY POINT UNSCHEK: Irrelevant 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 10 of 23 
IEAVNP25 - SVC PARMLIB Processing RIM 


IEAVNIPM 


\ 
> 


/ 
IEAVNP25 


The SVC Table RIM is called by IEAVNIPM to 


Process SVCPARM Statements from IEASVCxx 
members in SYS1.PARMLIB. For PARMLIB 
processing, IEAVNP25 uses the General 
Parmlib Scan Routine (IEEMBS888) to read 


PARMLIB based on the "SVC="" specification. 


IEEMB888 builds a logical record to pass 
to the Statement Processor routine 
(IEAVNS25 entry point in IEAVNP25). 
IEAVNS25 uses the Generalized Parser 
(IEEMB887) to parse the logical record. 
IEAVNP25 builds an entry in the SVC Table 
Work Area (SVCTWA) for each valid SVCPARM 
statement. If there is an invalid SVC= 
specification, the operator will be 
prompted via NIPPROMPT and PARMLIB 
processing will be re-initiated. odD1C 
Mainline processing continues after all 
SVC PARM statements have been read and 
parsed. IEAVNP25 scans the SVC Table Work 
Area (SVCTWA). For nucleus-resident SVCs 
(Type 1, 2 & 6), the SVC Table is updated 
using the SVC Dynamic Update Routine 
(IEAVESTU). For LPA-resident SVCs (Type 3 
& 4), IEAVNPSS5 will update the SVC Table 
based on data saved in the SVCTWA. 





IEAPPNIP Gy cas > 01 If there is an SVC= 


SVCT 


REGO 
NVT 


NVTSVCN 
PSCN Geese 
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specification 


A. Load PARMLIB Scan Routine 


. LOAD Generalized Parser 


C. Initialize IEEMB888 parameter list 


D. Initialize pointer to Statement Table 
Type Entry 


E. Initialize PARMLIB member name prefix 


F. Initialize Valid Statement Type Table 
Entry 


G. Initialize statement Keyword 


STEP 01 


ee 
CT — 
N 





\PSCN 


/ 
PSCNTABL 


\PSCN 


/ 
PSCNMEM 
PSCNSTMT 


\PSCN 


/ 
| PSCNSTAB 


\PSCN 


/ 
PSCNTYPE 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 11 of 23 


TEAVNP25 - SVC PARMLIB Processing RIM 


ae ee eee ee eee > 
ITEAVNS25 


TEAPPNIP 


SVCT 
—- ee ee eee > 
WORKAREA \ 
/ 









MAINLOOP 
TEAPPNIP poooea=---- > 
IHASVCT 





TWAPTR REG6 


PSCN : 


[Pscnenty | : 


IEAPPNi] ? 


NIPPTLST 


ON BLANK 





Z 





LPA_UPDATES 


NVT 
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STEP O1H 


H. Initialize Statement Processor name \PSCN 


I. Initialize Statement Processor address ee 
i 


J. Initialize address of pointer to 
"SVC="" specification 








K. Initialize address of workarea as User a 
Parameter Area 
PSCNUSEP 
PSCNNVT 
02 DOWHILE SVC Specifications 
left to process or until ; REG4 
SVCPARM processing REGS 
complete REG7 
A. Clear SVC Table Workarea to blanks \ 
/|\LPA_UPDA 


TES 


\PSCN 
/ 


B. If "SVC=( AA,BB. ».9L)" specified 
set on hardcopy list flag in 
Scanner Parameter List 








PSCNLIST 
PSCNFLAG 


C. Call General Parmlib Scan Routine 


ss 
\-—c7 IEEMB888 







, —————/ | ERR_CODE 


[cone 


\IEAPPNIP 


/ 
SVCT 


D. If SVC Specification error(s), issue 
message IEA821I 










E. ELSE SVCPARM statements are 
validated 


F. Call subroutine to perform updates 


su 
\—c7 UPPROC: 19 


0s o< 7s 0 Tilo «Til c+ Tilo «ils 2ial o+ Til «<a o- Tih oil oil oil oil o- Bal o- Bl ool c+Bil c+ ~ ile Muc+Iue-iac+Hic+Mus+Iie+Mle+Hue+Iis+Bis+Bi cells: Ie:) 


\ 
K RPARM 


\NVT 


/ 
NVTSVCN 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 12 of 23 


ITEAVNP25 - SVC PARMLIB Processing RIM STEP 02G 
-<----------- > \ 
/|ponase | 
/ 
G. Return | | 
SA®DBWD 
XN 7 
IEEMB888 
N 
> 
f 
ITEAVNS25 
PARAMETERS \ 
/ 
STMTPARM 
PARAMETERS J acecce---- >| H. Get data describing logical record \ 
a. 
I. IF Statement processor detected an \ 
error, set global error footprint /feucaate 
RROR 





STMT prcccccco >| J. IF EOP processing, RETURN to IEEMB888& [| 





---+----~--- >| K. ELSE Proceed with statement processing 
SAVEAREA2 \ 
4 


WORKPTR2 GPR13P 





> Pr PP 
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Diagram 31. SVC PARMLIB Processing (IEAVNP2S) Part 13 of 23 















IEAVNP25 ~- SVC PARMLIB Processing RIM STEP O2L 
------------ > L. Initialize Generalized Parser Scan \SCL 
\ Parameter List / 
/ 
SCL M. Call Generalized Parser 


s—N 


SCLNAME SCLVERID \r—7/ 


STMT 


ITEEMB887 


SCLPARM 






STMTSUFX STMTRECL 
STMTRECD STMTUSEP 
STMTNUMB 


/ | FOOTPRNT 
S 
TEMP_SVC 
TRAE 
TEMP_SVC 


ON BLANK 
OFF 


THAAL 


RANPAREN 

RANSVC# 

RANKEY 

END_OF_R 
EC 





03 IF Parser set return code 
field to indicate an 
unexpected error 


SCL J eee > 


SCLRET SCLBAD 


BLANK 












A. THEN call message routine 


sy 
Noon 7 MSG: 21 
"ITEA828I ', RAWKEY 





RAWSTMT# 













04 ELSE IF Parser set return 
code field to indicate a 
syntax error 


SCL J sees ==== > 


SCLRET  SCLBAD 






A. CALL End-of-statement subroutine 
to analyse the error 


sv 
\rou772 EOSTMT: 18 


B. IF Unable to identify specific 
syntax error 





C. Call message routine 
fro 
[sea 
‘IEA823IB', RAWKEY 





PPP PPpPprPprrpprprrprpprprrrprprprrrprrrprprrprrprrpprprprrprrprrbrrPrrprprprrprprprrrprrrprrprprrprprpprprprprprpp YP 


QOwwoqr nvnwwovwwvvvwvvTWwTTw 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 14 of 23 
IEAVNP25 - SVC PARMLIB Processing RIM STEP 05 


ELSE Statement 
processing complete 


A. Perform end-of-statement 
processing 


sy 
\rern 7 EOSTMT: 18 


B. Statement OK? Then copy \NVT 


temporary SVCTWA entry to to / 


permanent SVCTWA 
\ITHASVCT 


/ 
SVCTWAE 
SVCTWASX 


LOCAL_ERROR 
FLAGGED SVCXX 


NVTPTR 
TEMP_SVCTWAE 


STMT 






i 

i 

i 

i 

i 

t 

i 

i 

i 

i 

i 

t 

v 
PPrPrprYrrprprPprrKPprprrprYprrrrrr p YP 
OowwnwwnovwwwvvTwTewvwTvwTTD 


> 2?SEM_ENT MACDATE(86258 ) 
/ 
SVCSEM 


worn o------- >| A. Exit Routine Called by PARSER to handle 
SAVEAREAS3 \ <SVCNUM> token 
RANSVC# / 


WORKPTR2Z GPR13P 
TOKEN 





\| B. Convert <NUM> to binary 
TOKEN TEMP / 
DOUBLE 





en oe eee > 


SVCXX RAWSVC# 


N 
7 |RANKEY 











C. IF SVCNUM is invalid Call Message 


Routine 
MSG: 21 


sv 
"IEA833IA', RAWKEY 









\o— 7 


Pe 


\ 
/ \SVCOK 


BAD 


D. ELSE set SVCNUM footprint 


NZ NZ 


/|SVCOK 


\ 
‘\ 
> ?2SEM_ENT MACDATE( 86258 ) 
/ 


REPSEM 
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Diagram 31. SVC PARMLIB Processing (IEAVNP2S) Part 15 of 23 
IEAVNP25 - SVC PARMLIB Processing RIM STEP O7A 


aao--------- >| A. Exit Routine Called by PARSER to handle \ 
SAVEAREAS3 \ <REPLACE> Token /|WORKPTR2 
/ 


WORKPTR2Z GPR13P 











REPOK BLANK B. IF Token already processed call 
message routine 


/ \ 
a 
*ITEAS24I ‘», ‘REPLACE ' 


\| C. ELSE set footprint \ 
[Fuacceo aye Pa |Rerox | 
\ 
> ?SEM_ENT MACDATE(86258) 
/ 


EPNSEM 








------------ >| A. Exit Routine Called by PARSER to handle \ 
\ <EPNAME> Token /|WORKPTR2 
/ 





SAVEAREA3 


WORKPTR2 GPR13P 


ee > 
[EPNOK BLANK | B. IF Token already processed call 
message routine 


/ \ 
\r—/ MSG: 21 


"ITEA824I ‘, ‘EPNAME ' 
































SCL t ---------- >| C. ELSE store EPNAME in SVCTWA \ 
\ /|TEMP_SVC 
A 
A 
BLANK TOKEN A 
FLAGGED A 


‘ 
> ?SEM_ENT MACDATE(86258) 
/ 
EM 


TYPES 


woesneen---- >| A. Exit Routine Called by PARSER to handle \ 
SAVEARE A3 \ <TYPE> Token / |RORKPTR2Z 
/ 


WORKPTR2 GPR13P 











TYPEOK BLANK B. IF Token already processed call 
message routine 


yy 
MSG: 21 


\r—_si/?7 
"IEA829I *, ‘TYPE ' 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 16 of 23 
IEAVNP25 - SVC PARMLIB Processing RIM STEP 909C 


\} C. ELSE process token \ 
TOKEN / / | TYPEOK 








RAWKEY 


a oe ee > 
N 
/|TEMP_SVC 
TWATP 
\ D. IF Type specified is unrecognized \ 
BAD ‘TOKEN / mses | 


E. Call message routine 
L__] 





rPPYPrrYrrrrrrprrprrpry,r pp PF 
ouwuwwwanwvvnuvdd®D 


Vo oOo 0c oo 


A. Exit Routine Called by PARSER to handle 


<APF> Token WORKPTR2 
SAOBWD 
SAOFWD 
WORKPTR2 GPR13P GPR13P 
ae eee eee eee > 
APFOK BLANK B. IF Token already processed call 
massage routine 
/ ‘\ 
a 


“~ 
< 
> 
za 
mi 
p= 
w 

1 

1 

1 

1 

1 

r 

1 

1 

1 

1 

! 

N74 Y 








“IEA8241I '» ‘APF ° 








N 
> [13 2SEM_ENT MACDATE(86258 ) 
/ 

LOCKSSEM 


>| A. Exit Routine Called by PARSER to handle 
N <LOCKS> Token 
/ 





B. IF Token already processed call 
message routine 


/ N 
—L___ sea 





"IEA824I ‘, "LOCKS ' 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 17 of 23 
ITEAVNP25 - SVC PARMLIB Processing RIM 
C. ELSE set footprint 
| 


‘N 
> [22 | 2SEM_ENT MACDATE(86258) 
f 


LOCKISEM 


-cece------- >| A. Exit Routine Called by PARSER to handle 
SAVE ARE A3 \ a single lock Token 
/ 


WORKPTR2 GPR13P 











SCL poecmtesnco >| B. Move statement into working storage for 
: \ verification 

SCLSTRLN / 

RAWKE Y 

TOKEN ON 

eneccee----- >| C. IF lock was specified before Call error 

LOCKSOK I message routine 

FLAGGED sLy 

\r7 MSG: 21 


"IEA824I ', RAWKEY 





FLAGGED 


> [23] 2SEM_ENT MACDATE(86258 ) 


woes cscs---- >| A. Exit routine called by parser to handle 
SAVE AREAS \ <NPRMPT> Token 
/ 


WORKPTR2 GPR13P 











NPOK BLANK B. IF Token already processed call 
message routine 
/ \ 


\p—7 MSG: 21 


"IEA824I ', 'NPRMPT ' 





STEP 11C 


\ 
/ |LOCKSOK 





/ | WORKPTR2 





\ 
/ | LOCKSOK 


. | I 





/\WORKPTR2 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 18 of 23 
IEAVNP25 = SVC PARMLIB Processing RIM STEP 14 





Exit Routine Called by 
PARSER when a left 
parenthesis has been found. 
This routine sets up the 
detection of an unbalanced 
parenthesus syntax error by 
Saving away the keyword 
being processed. 





\ 





> [15] 2SEM_ENT MACDATE(86258 ) / |WORKPTR2 


/ 


1 LPAREN 
ee : 
\ 


WORKPTR2Z GPR13P 


SCL Sn >| A. Identify Keyword being processed 


7 
. — 
16 Exit Routine Called by | 
PARSER when an unrecognized 
key has been found inside of 
parenthesis. Error may be an 


unbalanced parenthesis or 
incorrect keyword option. 


WORKPTR2 
SAOBWD 
SAQFWD 


\ 
> 2SEM_ENT MACDATE(86258) 
/ 

UNBCHEK 


GPR13P 


SAVEAREA3 
I 







RAWPAREN 








WORKPTR2 GPR13P 
END_OF_REC 
TOKEN 







SCL 


teceee—----- >| A. Scan for parenthesis \ 
WORKPTR2 IOO01C \ 7 |WORKPTR2 
/ 


SCL 


END_OF_REC 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 19 of 23 
IEAVNP25 - SVC PARMLIB Processing RIM STEP 178 


\ 


al a ma a > 
/ AREN 


B. IF right parenthesis is found call 
WORKPTR2 message routine for invalid Keyword 
option 
s_—HN 


\ro7 


"IEA832I '» RAWPAREN 





------------ > C. Scan past right parenthesis N 
\ / | WORKPTR2 


“\ 


WORKPTR2 IO001C 


END_OF_PAREN 
END_OF_REC 













\ D. Raset PARSER's work pointer to \SCL 
WORKPTR2 / continue error scan / 
SCLCHAR 


E. ELSE call message routine for 
unbalanced parenthesis 
Ld 


PrP PrPpr br PP 








SAVEAREA3 | 


WORKPTR2Z GPR13P 





soccceses--- >| A. IF no SVC Number specified call message 

SVCOK BLANK routine 
fi. 

\r27 





---~--------- >IA 
SVCOK FLAGGED A | 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 20 of 23 
IEAVNP25 - SVC PARMLIB Processing RIM 


IHASVCT p---- ooo B. IF Duplicate SVCPARM for this SVC, 


issue informational message 








NVTPTR CVTPTR 
RAWSVC# FLAGGED 


STMT 





. Verify REPLACE IF mo REPLACE call 
message routine 


a 


REPOK FLAGGED 





‘IEASZ5I ', *REPLACE' 


Verify TYPE IF no valid TYPE call 


D. 
messa routine 
jruain 


TYPEOK BLANK 


[a 


‘IEA825I ‘» ‘TYPE ‘ 





Omaaanan 


. IF TYPE 374 Requests global lock 
call message routine 


sv 
\rn127 MSG: 21 
"IEAS823ID', * ' 


IF TYPE 6 requests any lock call 
messaga rtn. 


/ \ 
a ee 


TYPEOK SRMOK 


FLAGGED SALLOCOK 
DISPOK 





TYPEOK LOCKSOK 
BLANK 


*IEAS23IE‘,> ' ° 





e—O_—_——s— «i7TOr?:?:.}X,""=”~O&M 
a 


. IF no errors detected continue 
processing 


o 


oprccccco-- > 
LOCAL_ERROR : \ 
TYPEOK H / 


SCL : 


SCLRET SCLGOOD 


FLAGGED 













H. IF TYPE 1,2, or 6 


N44 YV 
PPprPrrPrrrrrprrrprrrrrrrrprrprrrrrprrrprprrprprrrrrprprprprrprrrprrrrrrrrprrrprrrrryprrrpryp rp YP 


RAWSVC8 CVTPTR 








STEP 18B 


\NVT 










\ 
/ | LOCALOK 


TEMP_SVC 
THEP 
TEMP_SVC 


TWANM 
REGS 
RPARM 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 21 of 23 
IEAVNP25 - SVC PARMLIB Processing RIM STEP 181 








I. IF ROUTINE NOT FOUND call 
message routine 
prema Ne 


MSG: 21 


TEMP_SVCTHWANM 





\—V/ 


"JEA826I ', RAWKEY 








J. ELSE LPA-Resident. IF no EPNAME 
was specified, format default 
LPA SVC Entry Point Name 





SVCXX UPKBUF 


IGCNAME 





>PPrPbrrpPrP PP pb bP bP bP PP PP bP b DP 


D 
D 
D 
D 
D 
D 
D 





19 Scan SVC Table Workarea and \ 
Call IEAVESTU to perform 7 |WORKPTR2 
updates 





IHASVCT a > 
3 
fT 
‘ \IHASVCT 
/ SVCUPFG1 
SVCTABLE : SVCUPNUM 
= SVCUPEP 
SVCUPAI1 
IHASVCT SVCUP APF 


SVCUPNPR 
SVCUPA2 


SVCTWEP SVCTWATP 
SVCTWAAP SVCTWANP 





SVCTWAA2 \ 
/|RPARM 
SVCURPTR 
I OFF 
SCVT 
SCVTSVCR 


A 
A 
A 
A 
A 
A 
A 
A 
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Diagram 31. SVC PARMLIB Processing (IEAVNP725) Part 22 of 23 





IEAVNP25 - SVC PARMLIB Processing RIM STEP 119A 
------------ A. Copy suffix to SVC Update \SVCTABLE 
IHASVCT 


A 
A 
A 
A 
A 
A 
A 
A 
A| 
A 


| LPA_UPDATES —— 


PARAMETERS \ Write Information Message to 
/ Operator for syntax errors 
MSGID PARMXX in SVCPARM statements 


\ 
/|LPA_UPDA 
TES 
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Diagram 31. SVC PARMLIB Processing (IEAVNP25) Part 23 of 23 
IEAVNP25 = SVC PARMLIB Processing RIM STEP 21 


N 
21 > \ 
/ 7 |\WORKPTR2 
MSG 
SAVE ARE AG al aseecennee > 
a \ 
/ 


WORKPTR2 GPR13P 
TEMP_SVCTWASX 
RAWSVC# MSG8&23B 
MSG823C MSG823D 
TYPEOK MSG823E 
MSG82G MSG825 
MSG825B RAWSTMTS 
MSG826 MSG828 
MSG833A MSG832 
RAWKEY 

BUF80_VAR 
FLAGGED NVTPTR 
CVTPTR 








PARAMETERS 


MSGID PARMXX 
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Diagram 32. Link Pack Area Initialization (IEAVNP0S5) Part 1 of 8 


IEAVNIPM 
(Stap 17) 





NVT 
=== 





| Initialize pageable 






NVTFLQOS — 7-74 
link pack area, 
NVTCSLIB -}—+~— | 
| L —_— a. Determine which type 
| of start is in progress. 
L 


Gi» b. For cold start, build 
PLPA and directory. 





System SYS1.LPALIB 
Catalog 
— 
TCB 
TCBJPO @ Open the LPALST 
concatenation. 
CVT GDA 






| 





CVTGDA 


= > e@ Build the PLPA 
and directory. 








NVT 
NVTPTAB 


PARMTAB 
————————— 


LPA=nonzero 





e@ Initialize QSRCD, 
EQSRD, and XQSRDs. 





SYS1.PARMLIB 


LPALSTx~x 
|IEAPAKxx 






See Diagram 29. 





PAR=nonzero 






u c 





JIEAVNPCS5 


PLPA 
build routine 


ILROSRIT 


Initialize 
QSRCD and 


EQSRD 





Virtual storage 


LPA directory 


es 
Last LPA 


module loaded 
NVTCSLNM 


NVTQSBUF 


ees 
Sis 
CT 
__ 


EQSRPLPS 
EQSRPLPE 


EQSRMAP 
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EQSRCD 
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Diagram 32. Link Pack Area Initialization (IEAVNPOS) Part 2 of 8 


Extended Description Module Label 
IEAVNIPM calls the contents supervisor RIM, IEAVNPOS, 

to initialize the link pack area (LPA). See Figure 1-6 for a 

description of virtual storage at the conclusion of the NIP 

process. 


1 ‘The link pack area (LPA) is an area of virtual storage 

containing reenterable routines that can be used con- 
currently by all tasks in the system. The contents supervisor 
RIM initializes the pageable LPA (PLPA) as follows: 


a. If the initialization is a quick or warm start (flag NVTFLOS 


is on), a PLPA and EPLPA exist from the previous system IEAVNPO5 
initialization. For information on building the PLPA and 
EPLPA, see Diagram 29, ILROSRIT. 

b. If the initialization is a cold start {flag NVTF LQS is of f) IEAVNPCS5 


the contents supervisor module, [(EAVNPC5 creates a 
PLPA, EPLPA and a directory in V=V storage. 
IEAVNPC5 uses fields in the global data area (GDA) to 
define the boundaries for the common storage area. It 
ensures that the LPA module library, SYS1.LPALIB 


IEAVNPC5 NPCSHOUS 


is Mounted and opened. If the “LPA”’ system parameter 
was specified, IEAVNPC5 validates the syntax. 
IEAVNPC5 then returns to IEAVNPO5, IEAVNPO5 
opens the LPALST concatenation and calls IEAVNPC5 
atentry point IEAVNPCL to build the PLPA. IEAVNPC5 
obtains the starting address of each LPALST data set (the 
directories) from the LPALSTs DEB, then reads the 
LPALST directory blocks. From thedirectory blocks, it 
builds a temporary LPA directory {INFOTAB) entry for 
each LPALST module and constructs INFOTAGB starting 
at the low end of the extended private area of storage. 
Later, IEAVNPCS5 will use the INFOTAB entries to load 
the modules and to construct the LPA directory entries. 


After IEAVNPCS5 builds the INFOTAB entries for 
LPALST, it processes the “PAK="' parameter. [IEAVNPC5 
calls IEAVNPM4 to read data from the specified 
IEAPAKxx members of SYS1.PARMLIB. The 
|[EAPAK xx members contain groups of modules in the 
LPALST that are executed together or in sequence. 
IEAVNPC5 uses [EAPAKOO to determine the order in 
which listed modules are to be loaded from the LPALST 
into the pageable LPA. 


IEAVNPCS5 computes the load addresses for the modules, 
beginning with any pack groups specified in the 
IEAPAKxx members. The load addresses of modules in 
the PLPA are calculated, beginning with the upper 
boundary of the PLPA assigning downwards until all 
addresses are calculated. Similarly, the load addresses 


IEAVNPM3 
IEAVNPC5 


IEAVNPM4 


[IEAVNPC5 


NIPMOUNT 
NIPOPEN 
NPACLIN 
NPA5INFO 


NPA5BLMQ 


NPA5GLOD 


Extended Description 


for modules in the EPLPA are calculated from the low 
boundary of the EPLPA, assigning upwards. The RMODE 
(residence mode) attribute in the PDS entry for amodule 
determines whether the module is loaded into PLPA or 
EPLPA. !EAVNPC5 loads modules contained in the 
same group into single or contiguous pages. If any 
member of IEAPAKxx does not exist, IEAVNPC5 issues 
a message to the operator and continues processing. 


When it has calculated all the load addresses, IEAVNPC5 
calls IEAVNPC8 to initialize the page tables for the PLPA 
and the EPLPA. It then loads the modules from the 
LPALST into V=V storage. 


As each module is loaded, |EAVNPCS5 stores the module 
name in field NVT CSLNM; in case of an error, |EAVNPC5 
uses this field to identify the last attempted LPA load. 
Also, as each module is loaded, |EAVNCP5 converts the 
associated INFOTAB entry toa link pack directory entry 
(LPDE) and overlays the INFOTAB entry with LPDE. 


After the last LPA module has been loaded, IEAVNPC5 
calls IEAVNPC8 to allocate storage for the directory, 
moves the directory to the next address lower than the 
PLPA, and places a pointer to the directory in field 
CVTLPDIR., [EAVNPCS5 moves the LPA hash value from 
the NVT to field CVTVVMDI. 


|EAVNPCS5 updates CVT fields CVTPLPAS, CVTPLPAE, 
CVTEPLPS, and CVTEPLPE with the low and high end 
addresses of the PLPA and EPLPA and pages the PLPA 
and the EPLPA out. 


IEAVNPCS5 calls the ASM quick start record initialization 
module, |LRQSRIT, to initialize the quick start record 
(QSRCD), the extended quick start record (EQSRD), 
and the quick start record extensions (XQSRDs). On 
subsequent warm starts, the ASM RIM, ILRASRIM 
reads the QSRCD, EQSRD, and XQSRDs from the PLPA 
data set to rebuild the PLPA and the EPLPA. ILRQSRIT 
moves the CVTVVMDI, CVTPLPS, CVTPLPE to the 
QSRCD, all the PLPA XPTLPIDs to XQSRDs, the 
CVTEPLPS, CVTPLPE, and CVTRWNS to the EQSRD, 
and all the EPLPA XPTLPIDs to the XQSRDs. 
ILRQSRIT then calls |LRPREAD to write them to the 
PLPA data set. 


Upon return from ILRQSRIT, the contents supervisor 
RIM enables the system to use the LPA directory by 
setting the directory available flag CVTDICOM. 


Module 


IEAVNPC8 


IEAVNPCS5 


IEAVNPC8 


IEAVNPC5 


ILRQSRIT 


IEAVNPODS 


Label 


NPA5ILOD 


NPASLOAD 


NPA5MLOD 


NPAS5CLPD 


NPASBDIR 
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Diagram 32. Link Pack Area Jnitialization (IEAWNPO0S) Part 3 of 8 


Input Process 


NVT 








NVTIPTAB 
PARMTAB 
eed 
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SYS1.PARMLIB 


TCB i] 
TCBJPQ 


CDE queue L | 


YS1.PARMLIB | 
Z == b, Pageable LPA 
modifications. 


ene, LPAL 
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2 Define modifications to LPA: 


a a. Fixed LPA modifications. 


CVTFLPAS 
CVTFLPAE 
CVTEFLPS 
CVTEFLPE 


Virtual storage 


EMLPA 
EFLPA 
EPLPA 


Extended nucleus 


CVTMLPAS 
CVTMLPAE 
CVTEMLPS 
CVTEMLPE 
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Diagram 32. Link Pack Area Initialization (IEAVNP05) Part 4 of 8 


Extended Description 


2 «By using the F|X and MLPA system parameters, the 
installation can modify the LPA as follows: 


a. The contents supervisor RIM checks the FIX entry in 
NIP’s PARMTAGB to determine whether the installation 
has specified modules to be added to the fixed LPA 
(FLPA). If the FIX entry is not zero, it contains the suffix 
list for an IEAFIXxx member(s) of SYS1.PARMLIB, 
which IEAVNPOS5 reads by calling IEAVNPM4. The 
IEAFIXxx member contains the names of modules that 
are to be loaded into the FLPA. 


The EFLPA is located in virtual storage directly above 
the EPLPA, and the FLPA is situated directly below 
PLPA. The RIM loads the modules from IEAFIXxx into 
the FLPA and EFLPA, using the RMODE attribute in 
the PDS entry for each module to determine whether the 
module is loaded into FLPA or EFLPA. |EAVNPOS5S 
calls IEAVNPC8 to initialize the page tables for the LPA 
storage. The contents supervisor RIM uses the CDE 
queue pointed to by NIP’s TCB to define any additions 
to the fixed LPA. 


As the RIM loads the modules into the LPA, it queues 
the load requests from the NIP TCB. After all modules 
have been loaded, the RIM places the address of this 
queue in field CVTOQLPAQ. It also updates the CVT 
fields CVTFLPAS, CVTFLPAE, CVTEFLPS, and 
CVTEFLPE with the low and high end addresses of the 
FLPA and EFLPA. The RIM now invokeés paging services 
to cause the FLPA and EFLPA storage to be page fixed. 


Module Label 
NP5SFIX 
JEAVNPM4 
IEAVNPOS 
NP5MLPRM 
NPSFIX 
[EAVNPC8 
IEAVNPOS5 
NPSQLPAQ 


Extended Description 


b. The contents supervisor RIM checks the MLPA entry 


Module Label 


NPSMLPA 
in NIP’s PARMTAB to determine whether the installation: 

has specified modules to be added to the PLPA. If the 

MLPA entry is not zero, it contains the suffix list for an 

[EALPAxx member(s) of SYS1.PARMLIB which 

IEAVNP0O5 reads by calling IEAVNPM4. The |EALPAxx 

member contains the names of the modules that are to 

be loaded into the PLPA. 


The RIM loads the PLPA and EPLPA modifications into 
virtual storage, using the RMODE attribute in the PDS 
entry for each module to determine whether the module 
is loaded into MLPA or EMLPA. The MLPA is located 
directly below the FLPA (if FLPA is present), and the 
EMLPA is directly above the EFLPA (if the EFLPA is 
present). Once the user-specified modules have been 
loaded, IEAVNPOS5 builds separate areas of the MLPA 
and EMLPA containing the device support modules 

that are named in the LPA device support module list 
(LPAL) and that reside in SYS1.LINKLIB. IEAVNPOS5S 
calls IEAVNPCE to initialize the page tables for the LPA 
storage. The RIM uses the CDE queue pointed to by 
NIP’s TCB to define any additions to the PLPA. 


NP5MLPRM 


IEAVNPC8 
IEAVNPO5 NPSQLPAQ 


The RIM updates the CVT fields CVTMLPAS, NPSMLPA 
CVTMLPAE, CVTEMLPS, and CVTEMLPE with the low 


and high end addresses of the MLPA and EMLPA. 
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Diagram 32. Link Pack Area Initialization (IEAVNP0OS5) Part 5 of 8 


Intput 


CVT SVC table 





CVTABEND 


SCVT 
SCVTSVCT 








SVC error routine 
(NVTIGCER) 


ABEND SVC save area 
(NVTABSAV) 


LOCATE SVC save area 
(NVTLOCAT) 





Process 


IEAVNPST 


initialize 
3 «Initialize SVC table: 


certain pro- 
gram product 
SVC entries 





CVTLPDSR 
IEAVVMSR 


LPDE 
search 


a. SVC module in LPA 
or LPA directory. 


b. SVC module not in 


-_ ~ oo 


c. ABEND SVC (SVC 13) 


d. LOCATE SVC 
(SVC 26). 





Output 


SVC table entry for LPA SVC modules 
A SVC module in LPA 


SVC table entry for module not in LPA 


A Error routine (IGCERROR) 


ABEND SVC save area in NVT 
A ABEND SVC module in LPA 


or 
4 Error routine (IGCERROR) 


LOCATE SVC save area in NVT 


4 LOCATE SVC module in LPA 
or 
A error routine (IGCERROR) 
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Diagram 32. link Pack Area Initialization (IEAVNPO0S5) Part 6 of 8 


Extended Description Module 


3. The SVC table contains one 8-byte entry for each 
system SVC routine. The contents supervisor RIM IEAVNPS5 
initializes entries for type 3 and type 4 SVC routines. For 
each entry that represents a type 3 or type 4 SVC routine, 
the RIM constructs the associated SVC name and determines 
whether the SVC routine is in the active link pack area. That 
is, the CDE for the SVC routine is on the CDE queue pointed 
to by IEAQLPA,. (This pointer resides in the nucleus and is 
pointed to by CVTQLPAQ.) 


a. Ifso, the RIM places the address of the SVC routine into 
the SVC table entry, If the RIM cannot find the SVC 
routine in the active LPA, it passes control to the super- 
visor LPDE search routine (IEAVVMSR), which resides 
in the nucleus; the entry point address of IEAVVMSR is 
in field CVTLPDSR. If IEAVVMSR finds the SVC routine 
in the LPA directory, the RIM places the address of the 
SVC routine into its SVC table entry. In either case, if 
the entry point address is resolved, the RIM sets an 
indicator (SVCAMODE) in the SVC entry to indicate 
in what addressing mode the SVC is to receive control. 


b. If the RIM cannot find a non-ESR SVC routine in either 
the active LPA or the LPA directory, the RIM moves the 
address of the non-ESR SVC error routine (IGCERROR) 
from field NVTIGCER to the SVC table entry. 
IGCERROR will cause an ABEND for a task that issues a 
request for an unavailable SVC routine. Finally, the RIM 
writes a message to the operator indicating the module 
that was not found. By initializing the type 3 and type 4 
SVC entries the program management RIM terminates the 
trapping of type 3 and type 4 SVCs that was set by 
IEAVNIPM., 


Label Extended Description Module Label 


c. Because NIP traps requests for the ABEND SVC (SVC 13), 
NPSSSVCT the SVC table entry for the ABEND SVC routine does not 
reflect the SYSGEN value: earlier in NIP’s processing, 
NIP saved the SYSGEN value for the ABEND SVC entry 
in a save area in the NVT (NVTABSAV). (For more 
information about NIP’s ABEND trap routine, refer to 
NPFNDSVC the ‘Diagnostic Aids’’ section of this publication.) The 
RIM treates the NVTABSAV as if it were the ABEND NPSSSVCT 
SVC routine in either the LPA or the LPA directory, the 
RIM places the address of the ABEND SVC routine in the 
save area; otherwise, the RIM stores the address of 
IGCERROR in the save area. As part of NIP’s exit process- 
ing, NIP moves the saved ABEND entry from the NVT 
NPFNDSVC into the SVC table. 


d. Because NIP traps requests for the LOCATE SVC (SVC 
26), the SVC table entry for the LOCATE SVC routine 
does not reflect the SYSGEN value: earlier in NIP’s proc- 
essing, NIP saved SYSGEN value for the LOCATE 
SVC entry ina save area in the NVT (NVTLOCAT). (For 
more information about NIP’s LOCATE trap routine, 
refer to the ’’Diagnostic Aids” section of this publication.) 
The RIM treates the LOCATE save area (NVTLOCAT) as 
if it were the LOCATE SVC routine in either the LPA or the 
LPA directory, the RIM places the address of the 
LOCATE SVC routine in the save area; otherwise, the 
RIM stores the address of IGCERROR in the save area. 
As part of NIP’s exit processing, NIP moves the saved 
LOCATE entry from the NVT into the SVC table. 
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Diagram 32. Link Pack Area Initialization (IEAVNP0S5) Part 7 of 8 
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section 1 

# 116 entries 
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ESR SVC 


error routine 
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Process 


4 Initialize ESR SVC table: 
a. Module on the 
active LPA queue. 


b. SVC module in the 
LPA or LPA 
directory. 


c. SVC module not in 
LPA or LPA 
directory. 





IEAVNIPM 


CVTLPDSR 


lIEAVVMSR 


Search 
link pack 
directory 
entry 





Output 


ESR SVC table entry for 
SVC module in the LPA 


ESR SVC table entry for 
SVC module in the LPA 


A SVC module 
in LPA 


ESR SVC table entry for 
SVC module not in LPA 


f Error routine 
(IGXERROR) 
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Diagram 32. Link Pack Area Initialization (JEAVNP0OS5) Part 8 of 8 


Extended Description Module 


4 The extended SVC router (ESR) SVC table contains 
one 8-byte entry for each ESR SVC routine, It 
differs from the system SVC table in that it consists of 4 
variable-length sections, An 8-byte prefix to each section 
of the ESR table contains the highest ESR SVC number 

for that section. 


a. The RIM initializes entries in each section for type 3 and 
type 4 SVCs. For each type 3 or 4 entry, the RIM 
constructs the name and determines whether the module 
is on the active LPA queue, that is, whether the CDE for 
the SVC routine is on the CDE queue pointed to by 
IEAQLPA (this pointer resides in the nucleus and is 
pointed to by CVTQLPAQ). 


b. If the module is on the active LPA queue, the RIM 
places the address of the SVC routine into the SVC table 
entry. If the RIM cannot find the SVC routine in the 
active LPA queue, it passes control to the supervisor 
link pack directory entry (LPDE) search routine 
(IEAVVMSR). If IEAVVMSR finds the SVC routine 
in the LPA directory, the RIM places the SVC routine’s 
address into Its SVC table entry. 


c. If the RIM cannot find the SVC routine in either the 
active LPA or the LPA directory, the RIM moves the 
address of the ESR SVC error routine (}|GXERROR) 
from field NVTIGXER to the SVC table entry. IGXERROR 
causes an ABEND for a task that issues a request for 
an unavailable ESR SVC routine. Because there may be a 
considerable number of unresolved type 3 and type 4 
ESR SVC entries, no message is written to the operator 
(as is done by the system SVC table routine), indicating 
the not-found condition. 
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Diagram 33. Auxiliary Storage Management Quick Start Record Initialization (ILRQSRIT) Part 1 of 2 
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Diagram 33. Auxiliary Storage Management Quick Start Record Initialization (ILRQSRIT) Part 2 of 2 


Extended Description Module 


Duringacold start initialization, the contents supervisor RIM, 
IEAVNPOS5, invokes ILROSRIT to save logical slot 1Ds 
(LSIDs) in the quick start record extensions (XQSRDs). The 
XQSRDs are written to the PLPA data set and the logical 
slot ID of each XQSRD is saved in the quick start record 
(QSRCD) for PLPA pages and in the extended quick start 
record (EQSRD) for the EPLPA pages. ILROSRIT then 
calls ILRPREAD to write the QSRCD, EQSRD and 
TPARTBLE to the PLPA data set. During subsequent 
quick and warm starts, the ASM RIM, ILRASRIM, will 
read these control blocks from the PLPA data set to rebuild 
the PLPA and EPLPA. 


1 Using the NVT pointer to the QSRCD (EQSRD fol- 

lows the QSRCD in contiguous extended SQA), store 
the PLPA and EPLPA values from the CVT (CVTVVMDI, 
CVTPLPAE, CVTPLPAS, CVTEPLPE, CVTEPLPS, 
CVTRWNS, CVTERWNE) into the OSRCD and EQSRD. 
(1EAIPLOS has written PLPA and EPLPA to auxiliary 
storage and saved the PLPA and EPLPA hash values before 
invoking ILROSRIT.) 


Check the ASMVT to determine if the PLPA and common 
data sets are full. If they are, indicate this condition in the 
QSRCD (QSRCOMMF=’1’). Inany case, zero the QSRMAP 
and EQSRMAP sections of the QSRCD and EOQSRD, 
Initialize the XOSRD. 


ILROSRIT 


2 The number of PLPA or EPLPA pages in the lowest 

segment is the number of pages specified in QSRPLPAS 
(or EQSRPLPS) subtracted from the number of pages in a 
segment (256). Compute the segment boundary address 
that contains the first page. Starting with the segment 
boundary address for the first page, invoke L|ARXXFP for 
the first page in the segment until the segment address is 
equal to QSRPLPAE (or EQSRPLPE) ({ARXXFP returns 
an external page table address.) Copy the logical slot id 


ILRQOSRIT 


IARXXFP 


ILROSRIT 


Label 


Extended Description Modute Label 


2 ~= (continued) 


(LSID) portions of each page table (PLPA slot and duplex 
slot information) to the LSID portion of the XOSRD. As 
each XQSRD is completed, write it to the PLPA data set 
or, if no space is available on the PLPA data set to the 
common data set. Save the LSID of the XOSRD in the 
QSRCD or EQSRD. Process all pages of PLPA and EPLPA. 
Continue with step 3. If IARXXFP fails to return an ex- 
ternal page table, issue message |EA943W to indicate that 
an error occurred while processing external page tables and 
then put the system into a X ‘060’ wait state. 


3 = After all PLPA and EPLPA page information has been 

copied to the QSRCD, EQSRD, and XOSRDs mark the 
PLPA data set as read-only and the common data set as 
active. 


A Write the TPARTBLE, the QSRCD, and the EQSRD 

to PLPA. If |LRPREAD fails, issue message |EA936D 
to notify the operator that future quick or warm starts for 
this IPL will fail. If |LRPREAD is successful, free the 
QSRCD and EQOSRD storage and delete I|LRPREAD. The 
TPARTBLE is not freed; it is still needed and will be freed 
by |LRTMIOO during master scheduler initialization, 


ILRPREAD 


Recovery Processing: 


None. 
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Diagram 34. CSA Parameter Initialization (IEAVNPBS8) Part 1 of 8 
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Diagram 34. CSA Parameter Initialization (IEAVNPBS8) Part 2 of 8 


Extended Description Module Label 


IEAVNIPM calls the virtual storage management (VSM) RIM, 
JEAVNPBS, to process the CSA system parameter and build 
the VSM control blocks and page tables necessary to describe 
the common storage area (CSA) and the extended CSA (ECSA). 
The syntax of the parameter is CSA=(a, b), where ‘a’ and ‘b’ 
are values that are multiplied by 1K to determine the total 
amount of storage that VSM is to allocate for the CSA and 
the ECSA. If the CSA parameter is not specified, the RIM 
uses the default CSA=(100, 100). 


1. The VSM RIM searches the CVT for the start address IEAVNPB8 IEAVNPB8 

of the LPA and the ending address of the ELPA. (These 
addresses were established by the contents supervisor RIM, 
{EAVNPOS.) The VSM RIM determines whether the LPA 
and the ELPA overlap into NIP’s private areas by comparing 
these two addresses with the end address of the private area 
(GDAPVT+GDAPVTSZ) and the start address of the ex- 
tended private (GDAEPVT). If there is an overlap, the RIM 
issues message |EA140W to inform the operator that there is 
no space available for CSA or ECSA and places the system in 
a wait state with a wait state code of X’0E3’. 


2 The VSM RIM validates the CSA parameter and ensures 
that the CSA and ECSA will not overlap the NIP private 
area. If invalid viaues for ‘a’ or ‘b’ were specified, the RIM 
issues message |EA3201 to inform the operator of the error. 
If a value was specified that would cause an overlap, the 
RIM issues message [E ASO9I to inform the operator that the 
value is too large. For both these error conditions, the RIM 
prompts the operator for a new value. 


VALIDATE 


If the value the Operator specified for ‘a’ causes the start 
address of the CSA to be below 8 megaby tes, the RIM issues 
message ]EA9131 to inform the operator that the private 
area js possibly constrained. 


Extended Description Module Label 


3 The VSM RIM issues a SETLOCK macro instruction to 
obtain the LOCAL and VSMFIX locks. There locks 
serialize access to the VSM queues and VSM workarea (VSWK), 


4 The VSM RIM frees some storage in ESQA that 

[EAIPLO4 allocated for common page tables. The RIM 
frees all this sotrage except the area that contains the page 
tables that describe the CSA and the ECSA. Before the RIM 
issues the FREEMAIN macro instruction for these areas, it 
calls IGVEAAQA to set on the address queue anchor table 
(AQAT) allocation bits to temporarily assign these areas to 
subpool 245. The RIM then issues the FREEMAIN macro 
instruction and ajusts GDAPGTAD and GDAPGTSZ to 
reflect the new address and size of the common area page 
tables. 


IGVEAAQA 


ITEAVNPBS [EAVNPB8S 
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Diagram 34. CSA Parameter Initialization (IEAVNPBS8) Part 3 of 8 
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Diagram 34. CSA Parameter Initialization (EAVNPB8) Part 4 of 8 


Extended Description Module Label 


5 The VSM RIM allocates and initializes the VSM'control 
blocks and page tables to describe the additional CSA. 


a. Now that the bounds of the non-extended private 
area are established, the RIM builds the free block 
queue element (FBQE) to describe the CSA and 
enqueues it on the CSA FBQE queue anchored in 
the GDA. 


b. The RIM calls the RSM module IARVB to build IARVB 
Page tables for the CSA. If there is not enough real 
storage available for the page tables, the VSM RIM 
issues message |EA907W to inform the operator 
that it is unable to initialize the page table for CSA 
and places the system in a wait state with a wait 


state code of X’03D’. 


c. The VSM RIM issues a GETMAIN macro instruction 
to obtain ESQA or SQA storage to build the subpool 
226 AQATs to describe the CSA. (This step and step 
6c are necessary because, when there is not enough 
storage available in the SQA or the ESQA, VSM con- 
verts storage from the CSA or the ECSA to the SQA 
or ESQA, These AQATs exist for this situation.) 
The RIM zeroes the AQATs, sets the AQAT index 
table entries (AQATINDXs) to point to the appropriate 
AQATs, and initializes the control block ID (AQATID). 
The VSM RIM initializes the subpool 239 and subpool 
245 AQATs for the CSA in the same way. 


IARVBCSG 
IEAVNPBS IEAVNPB8 


BUILDAQT 


Extended Description Module 


6 The VSM RIM allocates and initializes the VSM control 
blocks and page tables to describe the additional ECSA. 


a. Now that the bounds of the extended private area 
are established, the RIM builds the free block queue 
element (FBQE) to describe the ECSA and enqueues 
it on the ECSA FBQE queue anchored in the GDA. 


b. TheRIMcalls the RSM module I|ARVB to buildpage tables  |ARVB 
for the ECSA. If there is not enough real available stor- 
age for the page tables, the VSM RIM issues message 
IEA907W to inform the operator that it cannot initialize 
the page table for ECSA and places the system in a wait 


state with a wait state code of X‘03D’. 


l[EAVNPB8 


c. The VSM RIM issues a GETMAIN macro instruction to 
obtain ESQA or SQA storage to build the subpool 239 
AQATs to describe the ECSA. The RIM zeros the 
AQATs, sets the AQAT index table entries (AQATINDXs) 
to point to the appropriate AQATs, and initializes the 
control block ID (AQATID). The VSM RIM initializes 
the subpool 245 AQATs for the ECSA in the same way. 
(Note that the VSM RIM does not initialize subpool 
226 AQATSs because subpoo! 226 is only in non-extended 
virtual storage.) 
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lEAVNPB8 


BUILDAQT 
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Diagram 34. CSA Parameter Initialization (IEAVNPB8) Part 5 of 8 
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Diagram 34. CSA Parameter Initialization (IEAVNPBS8) Part 6 of 8 


Extended Description Module Label 


7 siLlf, after the RIM allocates the CSA and ECSA, there is lIEAVNPB8 
any space left between the CSA and the non-extended 

private area or between the ECSA and the extended private 

area, the VSM RIM adjusts the FBQE or builds a new FBQE 

to include the unused areas within the private areas. It also 

initializes fields in the LDA that contain information about 

the FBQE queues. 


8 = The RIM initializes RSM and VSM control blocks that 
contain information about the bounds of the CSA, 
the ECSA, and the private areas. 


9 The VSM RIM issues a GETMAIN macro instruction to 

obtain storage in subpool 245 for the CSA subpool table 
(SPT). This table contains DQE queue anchors for each CSA 
subpool/key combination for each of keys 0 through 15. It 
initializes the control block ID (SPTID) and the DQE anchors 
in the SPT. 
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Diagram 34. CSA Parameter Initialization (IEAVNPBS8) Part 7 of 8 
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Diagram 34. CSA Parameter Initialization (IEAVNPBS8) Part 8 of 8 
Extended Description Module Label 


10 Until this point in the initialization process, NIP and 

the RIMs are not able to issue GETMAIN and 
FREEMAIN macro instructions for storage in the CSA and 
ECSA because the SPTTINDX entry for these subpools 
points to a subpool translation table (SPTT) entry that is 
marked invalid. This will cause any GETMAIN macro in- 
struction that requests storage in a CSA or ECSA subpool to 
fail. The VSM RIM resets the SPTTINDX entries to point 
to the correct SPTT entries. 


11 The VSM RIM issues a SETLOCK macro instruction 
to free the LOCAL and VSMFIX locks and returns 
control to JEAVNIPM. 
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Diagram 35. Task Recovery Initialization (IEAVNPD6) Part 1 of 2 
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Diagram 35. Task Recovery Initialization (IEAVNPD6) Part 2 of 2 
Extended Description Module Label 


The recovery termination manager (RTM) RIM, |EAVNPD6 
initializes the recovery termination functions that support 
task recovery (ESTAE) and calls the SVC dump and ABDUMP 
RIMs to initialize the SVC dump and ABDUMP dumping 
services. 


1 For task recovery, the RTM RIM initializes CVTSV60 IEAVNPD6 

with the branch entry point address of the nucleus 
CSECT IEAVTRGS. This CSECT resides below the 16- 
megabyte line and contains the entry point for all BRANCH= 
YES requests for the ESTAE/ESTAI service routine. The 
RTM RIM then initializes the field JIEAVTRGT (an address 
constant in IEAVTRGS) with the address of the branch- 
entered ESTAE/ESTAI service routine, which resides above 
the 16-megabyte line. {IGCOQ0060 is also named I|EAVSTAO) 
The IEAVTRGT address constant enables IEAVTRGS to 
pass control to IEAVSTAQO in 31-bit addressing mode while 
preserving the addressing mode of the branch caller of 
ESTAE/ESTAI., 


The RTM RIM also initializes SCVTRG2 with the address of 
of the entry point to the interface routine (IEAVTRG2) that 
RTM2 (task recovery) uses to call the resource managers 

that must get control in 24-bit addressing mode. The RIM 
also initializes SCVTRG2B with the address of location 
IEAVTRGB in routine IEAVTRG2. IEAVTRGB is the 
return point for calls to the resource managers; it ensures that 
control returns to RTM2 in 31-it addressing mode. 
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Diagram 36. Supervisor Control RIM (IEAVNP09) Part f of 2 
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Diagram 36. Supervisor Control RIM (IEAVNP09) Part 1 of 2 


Extended Description Module Label 


Supervisor control controls the execution of tasks in an 
address space. The supervisor control RIM, IEAVNPO9Y, 
initializes task management by initializing the address 
Space vector table (ASVT), the address space first tables 
(AFTs). and the address space second tables (ASTs), as 
follows: 


1 Supervisor control initializes the ASVT with the |IEAVNPOQ 
maximum number of address spaces that may be 
created. Using the MAXUSER system parameter, the instal- 
lation can specify the maximum number of address spaces. 

Using the RSVNONR system parameter, the installation 
can specify the number of ASIDs reserved as replacements 
for non-reusable address sapces. Using the RSVSTRT sys- 
tem parameter, the installation can specify the number of 
ASIDs reserved for address spaces created in response to 
the START command. The RIM checks fields MAXUSER, 
RSVNONR, and RSVSTRT in PARMT AB to determine 
whether the installation specified a value. If the installation 
specified one or more invalid values, the RIM uses the 
NIPPRMPT service routine to prompt the operator for 
new values. If the installation did not specify MAXUSER, 
the RIM uses a default of 256 and issues message |EA8911. 
If the installation did not specify RSVNONR, the RIM uses 
a default of 5 and issues message IEA7361. If the instal- 
lation did not specify RSVSTRT, the RIM uses a default 
of 5 and issues message |EA7371. 


The total number of ASVT entries is the sum of the three 
system parameters. If this sum is greater than X’7FFF’, 
the RIM issues message |EA738i and prompts the operator 
to respecify all three system parameters. If the sum is 
within this limit, the RIM obtains storage for the ASVT 
and ASTs. If the installation specified a value too large 
for the available SQA space, the RIM issues message 
1EA8921 and prompts the operator to respecify all three 
system parameters. 


CC 


Extended Description Module Label 


2 ‘The RIM creates an entry in the ASVT for each pos- 

sible address space. For an address space already 
created, the RIM sets to zero the high-order bit in its as- 
sociated ASVT entry and places the address of the address 
Space’s ASCB into the entry. For those entries for which 
address spaces have not been created, the RIM sets the 
high order bit to 1 and places the address of the next avail- 
able entry into the current entry, TheRIM initializes field 
ASVTFRST to point to the first available ASVT entry. 
The RIM initializes field ASV TRSHD to point to the first 
available entry for those ASIDs reserved for started/SASI| 
address spaces, The RIM initializes field ASVTDSHD to 
point to the first available entry for those ASI Ds reserved 
as replacements for ASIDs which become non-reusable. 
The RIM initializes the CVT field, CVTASVT to point to 
the newly created permanent ASVT. 


If there is a valid pointer in the CVT to the global system 
data area, the RIM stores copies of the system parameters 
MAXUSER, RSVNONR, and RSVSTRT into the fields 
GSDAMAXU, GSDANONR, and GSDASTRT. The RIM 
saves the address of the permanent ASVT in GSDAASVT. 


3 TheRIMcreatesand initializes AF Tsand ASTs. There 

are two AFTs created: the hardware AFT, which is 
pointed to by SVTAFTR, and the backup AFT used, if 
required, to recreate the hardware AFT. SVTAFTV points 
to the backup AFT. The hardware AFT contains real ad- 
dresses; the backup AFT contains virtual addresses. Both 
AFTs are located in the private area of the master sched- 
uler’s address space. 


The ASTs are located in SQA. Each AST contains entries 
for 64 ASIDs. Each AFT entry is to contain the address 
ofan AST. If thehigh order bit of an AFT entry is 0, there 
ig avalid AST address in that entry; if the high order bit is 
1, there is no AST address in that entry. 


After the AFTs and ASTs have been initialized, the RIM 
loads control register 14 on the IPL processor with the 
real AFT address. The R!IMreturns control to!|EAVNIPM. 
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Diagram 37. REAL, VVREGN, and RSU Parameter Initialization (IEAVNPDS8) Part 1 of 8 
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Diagram 37. REAL, VVREGN, and RSU Parameter Initialization (IEAVNPD8) Part 2 of 8 
Extended Description Module Label 


IEAVNIPM calls the real storage management (RSM) RIM, i1EAVNPDS 
IEAVNPDS, to initialize RSM control blocks and process the 
REAL, VRREGN, and RSU system parameters. (The first 

module within IEAVNPD8 is IARMN). 


1. The RSM RIM searches the common area fixed frame IARMN IARMNRIM 
queue for frames in the fixed link pack area (FLPA), 

or extended FLPA regions. It calls the RSM service routine, 

|IARUMVF, to dequeue these frames. The RSM RIM IARUM |IARUMVF 

marks the frames permanently resident (PFTPERM=1) and 

places in PFTQID the ID that identifies the frames in 

FLPA. 


2 The RSM RIM locates the PFTE for the frame backing 

the page table for each common segment. It adds 4K 
to the fix count for the page table so that common segments 
will always appear to have valid pages. 


3 The RSM RIM issues a GETMAIN macro instruction 

for two contiguous pages of extended system queue 
area (ESQA) for the common segment table. If the two 
pages are valid in storage (PGTINV=0), the RSM RIM will 
not use these frames. It calls IARUMVF to move the frames |ARUM IARUMVF 
backing the pages to the available frame queue (AFQ). The 
RSM RIM places the real addresses of the frames backing the 
master scheduler segment table in the page table entries for 
the pages in (ESQA). The RSM RIM puts the virtual address 
of the common segment table in ESQA into the RSM 
address space block (RAB) for the common area. 
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Diagram 37. REAL, VVREGN, and RSU Parameter Initialization (IEAVNPD8) Part 3 of 8 
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Diagram 37. REAL, VVREGN, and RSU Parameter Initialization (IEAVNPD8) Part 4 of 8 


Extended Description Module Label 


4 The RSM RIM calls |ARMSRIM to process the REAL IARMS IARMSRIM 


da. 


and VRREGN system parameters. 


|IARMSRIM checks the size of the V=R region set up by 
IEAVNPES. If the V=R regions includes real addresses 
that the VSM RIM, IEAVNPBE, allocated to the common 
area (non-extended CSA) in virtual storage, the operator 
must reduce the size of the V=R region. |ARMSRIM 
issues Message number |AROQQ2A to inform the operator 
that the size of V=R is too large and prompts the oper- 
ator to respecify a new value for the REAL parameter. 
|ARMSRIM checks the operator's response for syntax 
errors and, if the response is not valid, issues message 
number I[AROO6GA to inform the operator that the 
parameter is invalid and again prompts the operator 

to respecify a new value. 


|ARMSRIM marks each frame that is removed from the 
V=R region as not V=R candidates and not V=R polluted 
and puts the beginning real address and the size of the 
V=R region in the global data area (GDA) for use by VSM. 
IARMSRIM puts the address of the first frame above the 
V=R area in the CVT. 


. [ARMSRIM checks the value specified by the operator 


for the VRREGN parameter. The VRREGN parameter is 
used as the default V=R region size for any job with the 
ADDRSPC=REAL parameter that does not have a 
REGION parameter. If the value is not valid, |ARMSRIM 
issues message number |AROOGA to request that the 
operator respecify a new value. 


|ARMSRIM places the default V=R region size in the 
GDA for use by VSM. 
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Diagram 37. REAL, VVREGN, and RSU Parameter Initialization (IEAVNPD8) Part 5 of 8 
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Diagram 37. REAL, VVREGN, and RSU Parameter Initialization (IEAVNPDS8) Part 6 of 8 


Extended Description Module Label 


FR The RSM RIM calis |ARMTRIM to process the RSU |IARMT |ARMTRIM 
Parameter. The RSU parameter specifies the amount of 

storage that RSM is to keep available for reconfiguration. It 

allots this area in increments based on the storage 

unit size. 


a. |IARMTRIM checks the RSU parameter. If the value is 
not valid, IARMTRIM issues message number |AROOGA 
to request that the operator respecify a new value for the 
RSU parameter. 


b. |ARMTRIM selects address increments that contain all 
offline, non-preferred storage to satisfy the RSU param- 
eter, beginning with the lowest address increment. If 
the RSU parameter has not been fully satisfied when the 
highest offline address increment has been selected, 
|[ARMTRIM selects online address increments beginning 
with the highest online address. If there are not enough 
address increments, |ARMTRIM issues the message 
number |AROO4I to inform the operator that the RSU 
Parameter was not Processed as specified. 


z. IARMTRIM marks the bands of address increments not 
used to satisfy the RSU parameter as preferred 
(AIMPREF=1) and marks each PFTE for the frames in 
the bands as preferred (PF TPREF=1). 


G The RSM RIMcalls |ARMFRIM to buildand initialize IARMF IARMFRIM 
the extended storage control blocks and queues that 

RSM needs to control any extended storage that might be 

configured in the system. If extended storage can be 

configured in the system, |ARMFRIM performs the following: 


a. Calculates the number of extended storage E-frames that 
can be configured in the system. 


b. Builds the extended storage table (EST) and the extended 
storage increment map (EIM). 


c. Marks the status of each extended storage frame in its 
corresponding extended storage table entry (ESTE). 


d. Builds the available ESTE queue and initializes the 
applicable fields in the RSM internal table (RIT) and 
the RSM control and enumeration area (RCE). 
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Diagram 37. REAL, VVREGN, and RSU Parameter Initialization (IEAVNPD8) Part 7 of 8 
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Diagram 37. REAL, VVREGN, and RSU Parameter Initialization (IEAVNPD8) Part 8 of 8 
Extended Description Module Label 


7 = The RSM RIM copies values from the RSM internal table |ARMN IARMNRIM 
(RIT) into the RSM refresh table (RSH) that is in the 
read-only nucleus. RSM uses these values to refresh the RIT. 


8 The RSM RIM calls the RSM service routine, [ARUFP, IARUF IARUFP 
to locate the PGTE for each page in the system area 
that is to be protected. It sets the protect bit in each PFTE. 
The following areas are protected: 
@ the read-only nucleus 
the nucleus map (NUCMAP) » 
the pageable link pack area (PLPA) 
the extended PLPA 
the fixed link pack area (F_LPA) and extended FLPA, 
unless requested otherwise on the FIX system parameter 
@ the modified link pack area (MLPA) and extended MLPA, 
unless requested otherwise on the MLPA system 
parameter 


Q The RSM RIM then calls the RSM service routine, IARUI IARUINV 
|IARUINV, to purge the translation lookaside buffers 
(TLBs). The RIM returns control to IEAVNIPM. 
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Diagram 38. System Resources Manager Initialization (IEAVNP10) Part 1 of 12 
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Diagram 38. System Resources Manager Initialization (IEAVNP10) Part 2 of 12 


Extended Description Module Label 


The system resources manager (SRM) supervises system 
resource usage by keeping those address spaces in real stor- 
age that best use system resources and meet the install- 
ation’s performance specifications (IPS), at any time and 
under any workload. Other system components communi- 
cate with the SRM by means of the SYSEVENT macro 
instruction. The issuing of aSYSEVENT prior to SRM RIM 
Processing results in a direct return to the issuer without any 
SRM processing. The SRM RIM initializes the system 
resource manager as follows: 


1 . The SRM RIM obtains the address of the SRM global 

save area from field WSAGOPTM in the global 
work/save area vector table (WSAG). The SRM RIM 
initializes field RMCTRMSA of the SRM control table 
(RMCT) with the address of the SRM global save area. For 
a description of the RMCT, refer to Data Areas. 


IEAVNP10 


2 ~ Several SRM constants related to processor execution IEAVNP10 
time depend on the processor model number and version 
code. The SRM RIM obtains the processor model number and 
version code of the IPL processor by issuing the store CPU ID 
instruction and uses them to find the model-dependent factor |RARMCPU IRARMCMD 
in the processor model table ((RARMCMD). The RIM saves 


the model-dependent factor in the field RMCTCPMP. 


The processor model table entry points to an array of 
multiprocessing adjustment rate factors. The SRM RIM copies 
the factors into the C@T (CCCMPAD,) and copies the demand 
paging rate default thresholds for MPL and adjustment from 
the model table entry to the CCT (CCCPRDEFL and 
CCCPADFH). 


The SRM RIM uses the model dependent factor saved in 
RMCTCPMP to compute the following: 


@ The number of instructions executed before a CPU-spin 
loop time out condition should be detected. The RiM 
saves this number in CVTEXSLF. 


@ The number of address spaces the dispatcher will be able 
to process in one second, which is when a timeout condition 
should occur. 


e The number of address spaces that memory switch and chap wil! 
be able to process in one second, which is when a timeout 
should occur, 


e@ The processor rate adjustment value (fleld RMCTADJC) 
in the RMCT. 


Extended Description Module Label 
e The processor control time interval (fields CCCAPMET, 


CCCMNUIN, and CCCMNSIN in the processor control 
table (CCT). 


@ The execution time thresholds (fields MCCSBETH and 
MCCSIETH) in the MCT. 
e The algorithm invocation interval (RMEPINT) in the 


SRM algorithm entry point blocks (RMEP) for the 
following routines: 


IRARMCL1, IRARMEQ1, IRARMCAP, IRARMIL1, 
IRARMAP1, IRARMASM, IRARMMS6, IRARMWM2, 
FRARMRM2. 


e The delay interval threshold (RMPTDLYD) in the 
RMPT. 


The workload manager evaluation interval threshold (field 
AMPTWMET) in the RMPT. 


For a description of the MCT, RMEP, RMPT, and 
CCT, refer to OS/VS2 Data Areas. 


3. Several SRM constants depend on the number of online 

processors. The SRM RIM obtains the number of online 
processors from field CSDCPUOL and places the value in 
field CCVCPUCT of the CCT. The SRM RIM uses the number 
of online processors and the multiprocessing adjustment rate 
factors to adjust the following: 


e@ The processor rate adjustment factor (RMCTADJC) 


@ The processor control timer interval (CCCAPMET) in the 
CCT 


@ The execution time thresholds (MCCSBETH and 
MCCSIETH) in the MCT 


@ The algorithm invocation interval (RMEPINT) in the 
RMEP for routine IRARMRM2Z. 


The RIM also initializes the following fields in the SRM 
resource control table (RCT): the dernand page rate low 
threshold (RCCDPRTL) and the demand page rate high 
threshold (RCCDPRTH). For a description of the RCT, see 
Data Areas. 
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Diagram 38. System Resources Manager Initialization (IEAVNP10) Part 3 of 12 
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Diagram 38. System Resources Manager Initialization (IEAVNP10) Part 4 of 12 


Extended Description Module Label 

4 The APG system parameter specifies an automatic 
priority group for use by the SRM. The SRM RIM 

finds the APG value using PARMTAB. If no value was 

specified (that is, the address of the APG value is 

zero), the SRM RIM uses a value of six. 


IEAVNP10 NP1O0APGP 


This APG value is then multiplied by 16 and saved in 
RMCTCVTA. 


5 The installation can supply tuning parameters to the 

SRM. These parameters are supplied in a member of 
SYS1.PARMLIB named IEAOPTxx. The installation uses 
the OPT system parameter to indicate the suffix for 
IEAOPT xx. 


The SRM RIM obtains the OPT-supplied suffix using 
PARMTAB. If no suffix was specified, the SRM RIM uses 
default values for the OPT parameters. If a suffix was 
specified, the RIM checks it for validity. 


Next the RIM checks the data in IEAOPTxx for validity 
using the OPT syntax table (OPSYNTAB) and stores the 
data temporarily in the OPT parameter list (OLST). 


IEAVNP10 NP10O0PTP 


IRARMOPT IRARMOPT 
IRARMANL 
IRARMOPT RMOPINIT 


C 


Extended Description Module Label 
The SRM RIM must adjust several of these parameters before IRARMOPT 
placing them in the OLST: 


e The resource factor coefficients are scaled to match the 
SRM'‘s recommendations. 


@ The enqueue residence value and the CPU significant- 
user threshold depend on the processor model and the 
number of processors online. Therefore, the SRM RIM 
must adjust them based on the model-dependent factor 
saved in the field RMCTCPMP, the number of processors 
(CCVCPUCT), and the multiprocessing adjustment 
factor (CCCMPAD,). 


e The SRM invocation interval depends on the processor 
number; therefore, it is adjusted based on RMCTCPMP. 


@ The UP or MP paging rate thresholds must be specified in 
the OPT parmlib member or the SRM RIM takes the 
default values from CCCPRDFL and CCCPRDFH. 


‘These values are then copied from the OPT parameter IEAVNP10 NP100OPTP 
list into SRM control blocks RMCT, RMPT, LSCT, 

MCT, RCT, CCT, and ICT. RMPTTOL and MCCSBSCF 

are based on the new values of RMPTTOM and 


MCCSBSTL respectively. 


For a more detailed description of IRARMOPT 
see System Logic Library. 
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Diagram 38. System Resources Manager Initialization (IEAVNP10) Part 5 of 12 


Input Process Output 
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Diagram 38. System Resources Manager Initialization (IEAVNP10) Part 6 of 12 


Extended Description 


6 The installation can provide SRM with the information 
needed to assign a performance group number (PGN) 


to a user based on the user ID, transaction name, or 


transaction class. Also, a separate report performance group 


number (RPGN) can be assigned so that user statistics can 
be collected independently at the same time as workload 
manager control. The information provided by the 
installation is called the installation control specification 
and is placed in a member of SYS1.PARMLIB named 
IEAICSxx. The ICS system parameter is used to indicate 
the suffix for IEAICSxx. 


The SRM RIM obtains the ICS system parameter value 
(the suffix) using PARMTAB. If no value has been 
specified, then SRM assumes that there is no installation 
control specification in effect. If a value was specified, 
the RIM checks it for validity, then stores the [|EAICSxx 
member name in field NIPPANAM of PARMAREA. 
The RIM then checks the IEAICSx:x list for validity using 
the installation control specification syntax table 
(ICSYNTAB), and builds the installation control 
specification table (ICSC) in SQA. The address of the 
ICSC is stored in RMCTICST. 


For a more detailed description of IRARMICS, see 
the system resource manager section of System Logic 
Library. 


Module Label 


IEAVNP10 IEAVICSP 


IRARMICS IRARMICS 


IRARMANL 


IRARMICS RMICINIT 


Extended Description 


7 ‘The installation specifies to the SRM’s workload 
Manager an install ation performance specification 
(IPS) consisting of: 


1) domain service rates, and 
2) priorities to be associated with users during thair 
processing. 


The installation places its IPS in a mamber of 
SYS1.PARMLIB named IEAIPSxx and uses the IPS 
system parameter to indicate the suffix for IEAIPSxx. 


The SRM RIM obtains the IPS parameter value (the 
suffix) using PARMTAB. If no value was specified, 
the RIM assumes that the default IPS in member 
|EAIPSOO is to be used. If a value was specified, the 
RIM checks it for validity, then stores the JEAIPSxx 
member name in field NIPPANAM of PARMAREA. 
The RIM checks the |EAIPSx:x list for validity using 
the IPS syntax table (IPSYNTAB) and stores the 

IPS data in the workload manager specification table 
(WMST), which the RIM constructs in the SOA. 


For a description of the workload manager specification 
table, refer to Data Areas. 


For a more detailed diagram of IRARMIPS, see 
System Logic Library. 
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Diagram 38. System Resources Manager Initialization (IEAVNP10) Part 7 of 12 
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Diagram 38. System Resources Manager Initialization (IEAVNP10) Part 8 of 12 


Extended Description Module Label 


8 The domain specification in the IPS enables the IEAVNP10 NP1OIPSP 
installation to discriminate between aggregates of 
users competing for resources. 


The SRM RiM extracts domain specification information 
from the WMST and stores it in the RMCT. Also, the 
positive and negative highest workload level in the WMST 
is stored in the ICT and CCT. Finally, the common 
storage isolation values are copied from the WMST to the 
MCT. 
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Diagram 38. System Resources Manager Initialization (IEAVNP10) Part 9 of 12 


Input Process Output 
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Diagram 38. System Resources Manager Initialization (IEAVNP10) Part 12 of 12 


Extended Description Module Label 


10 =‘ The limits of the IPS table are calculated. These 

will be used later by the measurement facility to 
determine the size of the table needed for workload 
data collection. 


IEAVNP10 


The highest performance group number specified in 
either the IPS or the installation control specification 
is the larger of WMSTMXPG or ICSCHRPG. This value 
is placed in WMSTPGHI. 


The number of unique periods in the combined IPS and 
installation control specification is the number of 
periods in the IPS (WMSTPERS) plus the number of 
report performance groups in the installation control 
specification (ICSCURPG) minus the number of report 
performance groups in the installation control specifica- 
tion that are also defined as performance groups in 

the IPS. The result of this calculation is stored in 
WMSTPGPC. 


11 After the SRM RIM has processed the parameters in the IEAVNP10 
IPS and the OPT that control the SRM timer entry 

frequency, the RIM completes the calculation and setting of 

the processor model dependent values. The RIM calculates 

the amount of time in a timer unit and saves this value in 

RMPTTUNT. 


It determines the frequency of sampling for 

channel measurements based on the target time between 
samples (CMCTSAMI) and the time in a timer unit. It saves 
this value in CMCTCTUN. Because the interval between 
channel measurement samples can be less than the length 

of a timer unit, the RIM saves the frequency as the number 

of timer units times a scaling factor of 16. (For example, 

a value of 8 in CMCTCTUN means that there is 8/16ths or 
one half of a timer unit is to elapse between channel samples.) 
The RIM saves the demand paging rate thresholds for MPL 
adjustment in RCT fields RCCDPRTL and RCCDPRTH. The 
RIM finds these values in CCCPRLOTn and CCCPRHITn, 
where n=1 or 2 depending on the number of processors online. 


Extended Description Module Label 


12 SRM user control blocks are created for each 
address space that is created. Because NIP creates 

the address space for the master scheduler, the SRM RIM 

must initialize the user control block (UOCB) and a user 


extension block (UOXB) for the master scheduler address IEAVNP10 
space. For a description of the UOCB and UOXE8, refer to 

Data Areas. 

13 The SRM RIM indicates that it has completed IEAVNP10 


SRM initialization by setting flag RMCTINIT in the 
RMCT. 
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Diagram 39. System Resources Manager Channel Measurement Initialization (IEAVNP1F) Part 1 of 6 
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Diagram 39. System Resources Manager Channel Measurement Initialization (IEAVNPIF) Part 2 of 6 


Extended Description 


The system resource manager (SRM) RIM, IEAVNP1F, builds 
and maintains five types of tables associated with channel 
measurements. The tables are: 


@ The channel path measurement table (CPMT), which 
describes the activity on the channel paths. It has one 
entry for each channel! path installed, regardless of 
whether the channel path is active at this installation. 


@ The channel measurement block (CMB), which contains 
subchannel counts and timing data on a device basis. 


@® The logical path control block (LPB), which contains 
data about the logical paths. A logical path represents 
a set of physical paths to a device or a group of devices. 

@ The device measurement block (DMB), which contains 
the device statistics that SRM maintains for device 
allocation and 1/O load balancing. For device allocation, 
there is one entry for each online device for which there 
has been a previous request. For |/O load balancing, 
there is one entry for each online tape device and DASD. 


@ The device block vector table (OBVT), which contains 
pointers to the LPB table (LPBT) entries and the OMBs. 


These SRM channel measurement functions are activated 
in module IRARMCHM as a result of a request by periodic 
entry point scheduling. 


The SRM RIM also initializes the CMB system parameter, The 
CMB (channel measurement block) system parameter allows 
an installation to designate the types of 1/O devices (in 
addition to tape devices and DASDs) for which measurement 
data might be collected. The SRM uses this information to 
calculate the required size for the CMB. 


Module 


Label 


Extended Description Module Label 


1 The SRM RIM indicates the channel measurement con- IEAVNP1F 
trol block structure is valid by setting bits (CMCTMFOK, 

CMCTDCOK, CMCTPAOK, and CMCTCMOK) on. The RIM 

obtains storage for the CPMT, with an entry for each channel 

path to the highest installed channel path 1D, and the STCPS 

workarea. If it cannot obtain storage, the RIM turns the 

CMCTPAOK and CMCTMFOK bits off and continues 


processing with step 6. 


2 TheSRM RIM calculates the number of CMB entries to 
include one for each tape device and DASD that was 
initialized or defined during the system generation process. 
It analyzes the installation-defined CMB keyword parameters 
to determine if the installation has requested additional 
entries for the channel-to-channel (CTC) adapters, communi- 
cation devices, graphics devices, and/or character readers or 
requested a specific number of entries. The SRM RIM then 
obtains storage for the required CMBs. Because the channel 
stores into the CMB without dynamic address translation, the 
virtual pages must reside in contiguous real storage. The 
SRM RIM calls module IGVNIPCR to obtain contiguous 
virtual storage, and IGVNIPCR calls IARXTIGU to obtain 
the contiguous real storage for the CMB. If IGVNIPCR is 
unable to obtain storage for the tape device and DASD CMB 
slots, the RIM turns CMCTMFOK off and continues processing 
with step 6. 


ANLCMB 


IGVNIPCR 


IARXT IARXTIGU 


3 The SRM RIM obtains storage for the DBVT. There is 

one DBVT entry for every CMB entry. If it cannot 
obtain storage, the SRM RIM turns CMCTMFOK off and 
continues processing with step 6. The UCB field UCBMBI 
provides a common index for the corresponding entries in 
these two control blocks. 
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Diagram 39. System Resources Manager Channel Measurement Initialization (IEAVNP1F) Part 3 of 6 


Process Output 


> 
x) 
c 
=e 


DBV TNAME 
4 Create logical path 
block table (LPBT). DBVTLPBO 
VT DBVTDMBP 


91807] WU] WaIskg VX/SAW (67-G 


Cc fs a 
ee 
CVTOPCTP 5 Establish ENF listen 
es cd 
@ vary device 
CVTUCBA e vary path 
i _ 
RMPTIOCS a 
RMCT 
;_ a ——— ey 
RMCTRMPT 
po 7 
RMCTWMST WMSTIOLB 


RMCTCMCT 


O = D 
: ; z 
4 = 4 


G Store LPB offsets [ood 
and build temporary 
device measurement 
blocks if load 


balancing is active.’ 


UCB 
7 TurnonCMB 
pea and/or DCT| 
UCB3DACC . 


CMCTMFOK 






ees 
SCHMCMB 
ene SCHMDCTI 
SS 


SCHMBI 





L861 ‘7861 “40D Wa W8UAdoD © ¥-00ZI-8ZAT 





Wal JO Aysadorg — sjetuayeya) posuaory 


ING JO STEMo7BTA, P93914}S94,, 


L861 ‘7861 “40D WI WY8uAdoD © 4-O0ZI-8ZAT 


uoneisdD Jo poyey “s UOT}IES 


16c°S 


C 


Cc 


Diagram 39. System Resources Manager Channel Measurement Initialization (IEAVNPIF) Part 4 of 6 


Extended Description 


4 TheSRM RIM obtains one page of storage for the LPBT. 
If it cannot obtain storage, the RIM turns CMCTMFOK 
off and continues processing with step 6. 


5G The SRM RIM establishes ENF exits to listen for three 


events: vary device online or offline, vary path, and DDR. 


G6 TheSRM RIM scans the UCB chain. If the UCB is for 

a tape device or DASD and CMCTMFOK is on, the RIM 
associates the device with an existing LPB table entry or 
obtains storage for another entry in the LPBT, builds the 
entry, and assigns the device class index. If the LPBT is too 
small to accommodate the new entry, the RIM gets a larger 
LPBT, copies the old LPBT to the new one, and frees the old 
one. If the RIM cannot obtain storage for expansion of the 
LBPT, it turns CMCTMF OK off. If load balancing is active, 
(that is, WMSTIOLB=1 and RMPTIOCS7=0), the RIM builds 
a temporary DMB for each tape device and DASD that is 
online. If the RIM cannot get storage for the DMBs, it turns 
CMCTMFOK off. 


J ~The RIM obtains storage for an SRB, |OSB, and 
subchannel information block (SCHIB). (The SRB is 
scheduled whenever a system routine requests asynchronous 
recording.) If CMCTMFOK is on and the device is a tape 
device (UCB3TAPE=1) or a DASD (UCB3DACC=1)}, the RIM 
turns both CMB and device connect time interval (DCTI) 


measurements on and stores the MBI index in the UCB. Other- 


wise, it turns on only the DCTI measurements. The RIM 


issues a synchronous modify subchannel request for the device. 


If the device is not available (that is, there is a non-zero return 
code from the modify subchannel request, MSCH), the RIM 
queues an asynchronous request and obtains storage for the 
next modify subchannel request. If the request for storage is 
unsuccessful, the RIM turns CMCTMFOK and CMCTDCOK 
off. If the device is boxed, in error, or not connected, |OS 
will store the information in the UCB for later placement in 
the subchannel. 


Label 
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DMBBUILD 
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Diagram 39. System Resources Manager Channel Measurement Initialization (IEAVNPIF) Part 6 of 6 
Extended Description Module Label 


8 The RIM frees storage associated with the modify sub- 
channel request and the unused portion of the LPBT. 

If CMCTMFOK is on, the RIM obtains storage for permanent 

DMBs. 


Q iif CMCTMFOK is off, the RIM frees the storage for the 

DBVT, LPBT, and DMB control blocks and issues 
message IEA966|. If CMCTDCOK is off, the RIM issues 
message IEA991I. 


IEAVNP1F returns control to |IEAVNIPM. 
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Diagram 40. ABDUMP Initialization (IEAVNPD1) Part 1 of 2 
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Diagram 40. ABI)UMP Initialization (IEAVNPD1) Part 2 of 2 


Extended Description Module Label 


1 ‘The installation can replace or modify IBM-supplied 

defaults for ABDUMP dumps by placing the default 
values in members of SYS1.PARMLIB. The ABDUMP RIM, 
IEAVTABI initializes ABDUMP control blocks and work 
areas. 


a. The installation specifies defaults for SYSABEND dumps lIEAVTABI 
by placing default values in |IEAABDOO, The ABDUMP 
RIM searches SYS1.PARMLIB for [EAABDOO, scans 
the default values, then places the values in field 
RTCTSAP of the RTCT. If the operator does not use the 
CHNGDUMP operator command to specify other options 
(via the add or override option), ABDUMP will use these 
default options and merge them with other dump options 
specified (via the CALLRTM, SETRP, or ABEND macro 
instructions) before the dump occurs. 


b, The installation specifies defaults for SYSUDUMP dumps 
by placing default values in IEADMPOO. The ABDUMP 
RIM searches SYS1.PARMLIB for [|EADMPOO, scans the 
default values, then places the values in field RTCTSUP 
of the RTCT. If the operator does not use the 
CHNGDUMP operator command to specify overrides or 
adds, ABDUMP will use these default options and merge 
them with other dump options specified (via the 
CALLRTM, SETRP, or ABEND macro instructions) 
before the dump occurs, 


c. The installation specifies defaults for SYSMDUMP dumps 
by placing default values in IEADMROO. The ABDUMP 
RIM searches SYS1.PARMLIB for |EADMROO, scans the 
default values, then places the values in field RTCTSYD 
of the RTCT. If the operator does not use the 
CHNGDUMP operator command to specify overrides or 
adds, ABDUMP will use these default options and merge 
them with other dump options specified (via the 
CALLRTM, SETRP, or ABEND macro instructions) 
before the dump occurs. 


2 ‘The ABDUMP RIM issues a LOAD macro instruction 
to locate the linkage-assist (glue) routines that are 
needed for SNAP/ABDUMP processing. These routines are: 

IEAVADGL, IEAVADG1, IEAVADG2, IEAVADG3, 
IEAVADG4 and IEAVAD12 (which are aliases of 
IGCO805A) and IEAVTABG, IEAVTABOQ and IEAVTABR 
(which are aliases of |EAVTRG2). 


The RTM RIM returns control to IEAVNIPM. 
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Diagram 41. SVC Dump Initialization (EAVNPDI) Part 1 of 12 
IEAVTSDI - MODULE DESCRIPTION 


DESCRIPTIVE NAME: SDUMP INITIALIZATION RIM 

FUNCTION: 

THE SVC DUMP NIP RIM INITIALIZES THE SVC DUMP DATA 

AREAS. 

ENTRY POINT: IEAVTSDI 

PURPOSE: INITIALIZE SVC DUMP DATA AREAS. 

LINKAGE: PLS CALL STATEMENT 

CALLERS: None 

INPUT: None 

OUTPUT ; 
CONTROL BLOCKS ARE GETMAINED AND INITIALIZED, AND 
SVC DUMP MODULES ARE LOADED. 

EXIT NORMAL: RETURNS TO CALLER 

EXTERNAL REFERENCES: 

ROUTINES: NIPWTO - WRITE MESSAGES DURING NIP 


CONTROL BLOCKS: 





COMMON LIBRARY 

NAME NAME ACCESS 

ASCB IHAASCB READ 

CVT CVT READ 

DFL ADYDFLM CREATE »READ »WRITE 
DSCA ADYDSCA CREATE ,READ ,»WRITE 
DSPD ADYDSPD CREATE 

DSTAT ADYDSTAT CREATE 

DSVCB IHADSVCB CREATE,READ,WRITE 
ERRWORK IHASDERR CREATE,READ 

GDA IHAGDA READ 

LDA IHALDA READ 

NITOHDR IEAPMNIP READ 

NIPPAHDR IEAPPNIP READ 

NVT IHANVT READ 

PSA IHAPSA READ 

RTCT IHARTCT READ »WRITE 

RTSD IHARTSD CREATE ,READ,WRITE 
SDCON IHASDCON CREATE,READ,WRITE 
SDDAT IHASDDAT CREATE,READ>WRITE 
SDDIE IHASDDIE CREATE ,WRITE 
SDEXPARM IHASDEXP CREATE ,WRITE 
SDMOD IHASDNOD CREATE,READ,WRITE 
SDTAB IHASDTAB CREATE,READ,WRITE 
SDUMP IHASDUMP READ 

SDWA IHASDWA READ 

SDWORK IHASDWRK $CREATE,READ,WRITE 
SMDLR IHASMDLR REFERENCED BY SMNK ONLY 
SMWK ITHASMWK CREATE »READ, WRITE 
SMWKRSCB ITHASDRSB CREATE 

SRB IHASRB READ 

TQE IHATQE READ 

TRCT IHATRCT READ 

TRSN IHATRSN READ 

VRA IHAVRA READ 

VSMDSP IGVVSMD REFERENCED BY SDTAB ONLY 
UCB IEFUCBOB REFERENCE CONSTANTS ONLY 
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Diagram 41. SVC Dump Initialization (EAVNPDI) Part 2 of 12 


IEAVTSDI - MODULE DESCRIPTION (Continued) 


SERTALIZATION: 
RTCTSDPL AND CVTSDBF(HIGH-ORDER BIT) ARE SET 
TO SERIALIZE ALL OF THE SVC DUMP PROCESS. 
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Diagram 41. SVC Dump Initialization (TEAVNPDI) Part 3 of 12 
IEAVTSDI ~ MODULE OPERATION 


1. GETMAINS THE FOLLOWING STORAGE AREAS AND SAVES THE ADDRESSES 
IN THE INDICATED CONTROL BLOCKS: 
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ERROR WORK AREA 
SYSTEM TRACE SNAPTRC 
PARAMETER LIST 
SYSTEM TRACE COPYTRC 
PARAMETER LIST 

SDUMP MODULE PTRS 
PTR IN SDDAT 

SDUMP CONSTANTS 

PTR IN SDDAT 

SDUHMP DIE CONTROL 
BLOCK FOR SYSTEM NON- 
DISPATCHABILITY 
SDUMP DIE CONTROL 
BLOCK FOR THE REAL 
STORAGE BUFFER 
SUMDUMP WORK AREA 
FOR SUMDUMP FORMATTER 
SDUMP WORK AREA 


SINGLE RECORD 

OUTPUT BUFFERS 

SDUMP 4K BUFFER 

SUNDUMP REAL STORAGE 
BUFFER CONTROL BLOCK 
RECOVERY TERMINATION 
SOUMP EXTENSION 

COPY OF SDWA RECORDABLE 
AREAS 

SDUMP VSMLIST TABLE 


SDUMP EXIT PARAMETER 
LIST 

DUMPSRV ADDRESS SPACE 
CONTROL BLOCK 

DAE COMMUNICATION 
AREA 

DAE PRE AND POST DUMP 
PARAMETER LIST 

DAE DEFAULT OPTIONS 


COPY OF DUMP HEADER 
RECORD 
COPY HEADER PTR 


2. DETERMINES THE ADDRESSES OF SVC DUMP LPA AND NUCLEUS MODULES 
AND SAVES THE ADDRESSES IN THE SVC DUMP CONTROL BLOCK SDMOD. 
THE SDMOD INITIALIZATION LIST (SDMILIST) CONTAINS A 
DESCRIPTION OF EACH MODULE PROCESSED. 


3. LOADS IEAVTSXT WHICH CONTAINS A TABLE OF SVC DUMP EXIT 


MODULES. 


IEAVTSDI COUNTS THE NUMBER OF EXITS, GETS STORAGE 


FOR THE SVC DUMP EXIT TABLE (RTSDEXIT) FROM FIXED SQA, 


SUBPOOL 239, AND SETS RTSDEXTB TO POINT TO IT. 


SVC DUMP 


USES THIS EXIT TABLE TO INVOKE THE DUMP EXIT MODULES. 


4. LOADS EACH EXIT MODULE LISTED IN IEAVTSxXT. 


IF THE LOAD WAS 


SUCCESSFUL, STORES THE ADDRESS IN THE SVC DUMP EXIT TABLE 


5-298 MVS/XA System Init Logic 


LY28-1200-4 © Copyright IBM Corp. 1982, 1987 











“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Diagram 41. SVC Dump Initialization (EAVNPDI) Part 4 of 12 


IEAVTSDI - MODULE OPERATION (Continued) 


(RTSDEXIT) AND DELETES THE MODULE WHICH WILL FREE THE CDE 
ENTRY ASSIGNED TO IT. IF THE LOAD FAILED, ISSUES MESSAGE 
IEA883I. IF NO VALID EXITS ARE FOUND, FREES THE SVC DUMP 
EXIT TABLE AND SET POINTER (RTSDEXTB) TO ZERO. 


5. CALLS MODULE IEAVTSDD TO PARSE THE SYSTEM PARAMETERS DUMP 
OPTION, AND TO INITIALIZE THE SYS1.DUMP DATA SETS. 


6. GETMAINS THE FOLLOWING STORAGE AREAS AND SAVES THE 
ADDRESSES IN THE INDICATED CONTROL BLOCKS: 


CONTROL ADDRESS SUBPOOL SIZE DESCRIPTION 
BLOCK STORED 


aD1A 


CCWIDAW SDDFTCCW 227-CSA (24%(MAX RECS CCWS & IDAWS FOR 
PER TRACK ) )+32 FULL TRACK WRITE 

OUTPUT SDDFTBUF 231-CSA 8224%(MAX RECS FULL TRACK WRITE 
PER TRACK ) OUTPUT BUFFERS 
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Diagram 41. SVC Dump Initialization (EAVNPDI) Part 5 of 12 


IEAVTSDI - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAVTSDI 


MESSAGES: 
MESSAGE ID: IEA883I 
MODULE XXXXXXXX NOT FOUND 
THIS MESSAGE IS ISSUED FOR ANY SVC DUMP MODULE 


WHICH CANNOT BE LOADED AS WELL AS 
ANY OTHER DUMP EXIT MODULES SPECIFIED IN IEAVTSXT 


ABEND CODES: None 


WAIT STATE CODES: None 


RETURN CODES: 
EXIT NORMAL: 


O - PROCESSING COMPLETE 


REGISTER CONTENTS ON ENTRY: 


REG 2 - ADDRESS OF NVT 

REG 3 - ADDRESS OF CVT 

REG 13 - ADDRESS OF STANDARD SAVE AREA 
REG 14 - RETURN ADDRESS 

REG 15 - ENTRY POINT ADDRESS 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 


SAME AS ENTRY REGISTERS 
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Diagram 41. SVC Dump Initialization (EAVNPDI) Part 6 of 12 
IEAVTSDI - SDUMP INITIALIZATION RIM STEP 01 


\ THE SVC DUMP NIP RIM INITIALIZES THE SVC 
>| |DUMP DATA AREAS. 


/ 
IEAVTSDI 





01| GETMAINS AND INITIALIZES Svc 
DUMP CONTROL BLOCKS. 

fey 

\r— SDISPACE: 06 


INITIALIZES THE EXIT TABLE 
Ut 
\r—17 EXITINIT: 11 


\IKANVT 


/ 
RNVT 
RCVT 






PROCESSES DUMP DATA SETS 
suIN 


\r—/ TEAVTSDD 


04 | GETMAINS THE OUTPUT BUFFERS, 
CCWwS AND IDAWS FOR FULL 
TRACK WRITES 
L__ 


/ \ 
—"_ amos] 
CVT \ \THARTCT 
/ / 
era 


\CVT 
/ 


CVTSDBF 
RETURNS TO CALLER 
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Diagram 41. SVC Dump Initialization (QEAVNPDI) Part 7 of 12 


IEAVTSDI - SDUMP INITIALIZATION RIM STEP 06 
\ 
06 > GETHAINS AND INITIALIZES ALL 
/ SVC DUMP AND DAE CONTROL 


SDISPACE BLOCKS 





GETMAINS STORAGE FOR THE 
EACH DATA AREA. 


CLEARS THE GETMAINED STORAGE 


DETERMINES WHICH DATA AREA 


HAS HAD STORAGE GETMAINED 
FOR IT. 


IHASDDAT pr-oonoo >| A. WHEN THE DATA AREA IS SDDAT, INITIALIZES \IHARTCT 


-: \ IT / 
RTCTSDAT 


SDDAT SDDLVLWK| : / 
SODSRBA SDDSAMAP 

\TRKASDDAT 
/ 


THASDERR 


>DDIB 

SDDERR VIX 
SDDTRSN 
SCDTRCT 


ERRWORK 


THASRB 
SODLVLWA 
SDDLVLSA 
SDDSRBA 


IHATRSN SDDCLEAR 





\IHATRSN 
/ 


TRSN TRSNID 


ITHATRCT TRSNID 


\THATRCT 
/ 


TRCT TRCTID 


IHASDDAT TRCTID 


\ITHASDDAT 


/ 
SODRNGTB 
SDDRNGTE 


\IHARTCT 


/ 
RTCTSCON 


\IHASDDAT 


/ 
SDDSDCOW 


SDDIDL SODERRWK B. WHEN THE DATA AREA IS THE RANGE TABLE, 
SDDTRSN SDOTRCT INITIALIZES THE POINTERS TO IT. 
SDDLVLWS 





ITHASDCON \] C. WHEN THE DATA AREA IS SDCON, INITIALIZES 


/ IT. 










IHALDA 
LDASTRTS 


IHAGDA 


ML 
2 






GOAPVT GDAPVTSZ 
GDAEPVT GDAEPVTS 
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Diagram 41. SVC Dump Initialization TQEAVNPDI) Part 8 of 12 


IEAVTSDI - SDUMP INITIALIZATION RIM 


IHASDDIE po--------- > 










SDDIE 
SDDIEWA 


SODIESA 


IHATQE 
TQE 


IHASDDIE 







SDDIECON SDDIETQP 
SODIESAV SDDIEWKA 
SDDIDISC SDDISUSC 
SDDISYSC SDODITSKC 







IHASDMOD 







SDMID1 
SOMRPARB 


>DMSDRB 








IHASMWK oy > 
\ 
/ 


IHASMWK 


IHASDRSB Sn > 
IHASDWRK py > 
N 






SDCLEAR 


IHASDWRK 
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OD. WHEN THE DATA AREA IS THE RSB OR THE 


NON-DISPATCHABILITY TIMER DIE, 
INITIALIZES THE SDDIE'S 


. WHEN THE DATA AREA IS THE SDMOD, 


INITIALIZES IT 


. SAVES THE ADDRESS OF SDMOD IN THE RTCT 


FOR USE BY SYSMDUMP 


. SAVES THE ADDRESS IN THE SDDAT FOR USE 


BY SVC DUMP. 


. SETS THE IDENTIFIER IN SDMOD 


. WHEN THE DATA AREA IS THE SMWK, 


INITIALIZES IT 


» WHEN THE DATA AREA IS THE SMNKRSCB; 


INITIALIZES IT 


. WHEN THE DATA AREA IS THE SOWORK;, 


INITIALIZES IT 


STEP 


||| | atl] 


Section 5. Method of Operation 


09D 


\THARTCT 


/ 
RTCTOIND 
RTCTDIRS 


\THASDDIE 
/ 


SDDIEWKA 


SDDIEDIS 
SDDIESUS 
SDDIESYS 
SDDIETSK 


IHARTCT 





\ 
/ 
RTCTSMOD 


\IHASDDAT 


SDDSDMOD 


‘\ 


7 

H 
oa 
> 
th) 
cs 
= 
O 
=) 


‘\ 


\OVT 


CVYTSDRM 


‘\ 


\ITHARTCT 


RTCTRPAR 


‘\ 


\IHARTCT 
RTCTSDSHW 


\IHASDDAT 


‘\ 


SDDSMAK 


‘\ 


\IHASMWK 


‘\ 


\ITHASMNHK 
/ 


\IHASDDAT 
/ 
SDODSDWRK 


\IHARTCT 


RTCTSDINK 


‘X 


a“ 
M 
— 
> 
i¢ A) 
= 
me 
AJ 
A 


‘X 


5-303 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Diagram 41. SVC Dump Initialization (EAVNPDI) Part 9 of 12 


IEAVTSDI - SDUMP INITIALIZATION RIM STEP O9L 
IHASDTAB Se >| L. WHEN THE DATA AREA IS THE SDTAB, 
\ INITIALIZES IT 


SDDSDTAB 


SDTAB SDTIDENT 








\IHASDDAT 
"[foasoras] 
IHASDOTAB \IHASDOTAB 
/ 
IHASDEXP J @---------- >| M. WHEN THE DATA AREA IS THE SDEXPARM, \IHASDDAT 
INITIALIZES IT / 
IHARTSD J ---------- >| N. WHEN THE DATA AREA IS THE RTSD» \IHARTCT 
\ INITIALIZES IT 


RTCTRTSD 


\IHARTSD 


‘\ 


RTSD RTSDKEEP 


IHARTSD 


‘\ 





J | Jl 








RTSDID 
IHASDWA I oo-------- >| O. WHEN THE DATA AREA IS THE SDWA COPY \ITHASDDAT 
AREA, INITIALIZES IT / 
SDWARC2 SDWARC3 
SDWAPTRS 
IHADSVCEB J ----=~---- >| P. WHEN THE DATA AREA IS THE DSVCB; \IHARTCT 
\ INITIALIZES IT / 
DSVCB DSVCOMM / RTCTOSV 
DSVOMPDS DOSVEXPRC 
\IHADSVCB 
IHARTCT / 
DSVID 
RTCTDSV DSVPCCMM 
DSVPDDS 
IHADSVCB DSVPEXIT 
OSVPDAE 
OSVPCOMM DSVPDDS DSVDATIN 
DSVPEXIT 
IHASDMOD 
SOMSDAB 
ADYDSCA J ~--------- >| Q@. WHEN THE DATA AREA IS THE DSCA; \IHARTCT 
\ INITIALIZES IT / 
ADYDSCA \ADYDSCA 
/ 
DSCVSNC OSCID 
IHARTCT 
RTCTDOSCA 
IHASDMOD 


SOMPREDB SDiNEXTB 
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Diagram 41. SVC Dump Initialization (IEAVNPDI) Part 10 of 12 


IEAVTSDI - SDUMP INITIALIZATION RIM 


ADYDSPD Ei ---------- >| R. WHEN THE DATA AREA IS THE DSPD, 
\ INITIALIZES IT 
DSPD DSPID / 






ADYDSPD 


S. WHEN THE DATA AREA IS THE COPY OF HEADER 


RECORD STORAGE, INITIALIZES IT. 


IHASDWRK ai ---------- >| T. WHEN THE DATA AREA IS THE OUTPUT BUFFER, 
\ INITIALIZES IT. 
/ 


SDOUTBUF SDOBUFFER 
SOWBFHDR 


LOADS THE DAE INITIALIZATION 
IHASDDAT 


ROUTINE 


s_—44v 
\r—/ LOADDFLT: 24 






SDDOBUF F 


11 > INITIALIZE THE SVC BUMP EXIT 
/ TABLE 
EXITINIT 


12| LOADS MODULE IEAVTSXT 
sel 


\r—/ LOADMOD: 20 


IF THE LOAD WAS SUCCESSFUL, 
PROCESSES THE SVC DUMP EXITS 


IHARTSD af S==-5-SS=— >| A. IF EXITS EXIST, GETMAINS STORAGE FOR THE 
EXIT TABLE 


RTSDEXIT 
B. LOOPS THRCUGH TEAVTSXT, AND LOADS EACH 


EXIT AND STORES A POINTER TO IT IN THE 
RTSDEXIT TABLE 


C. LOADS SPECIFIED EXIT 


NN 
\r—c/ LOADMOD: 20 





STEP O9R 


IrHASDDAT 


\ 
/ 

; SDDDSPD 
\ADYDSCA 
/ 

j OSCDSPDP 
\ADYDSPD 
ri 

OSPID 
\IHASBDOAT 


/ 
\ADYDSCA 
/ 


\THASDDAT 





\ITHARTSD 
/ 


RTSCEXFL 
RTSDEXAD 
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Diagram 41. SVC Dump Initialization (EAVNPDI) Part 11 of 12 
IEAVTSDI - SDUMP INITIALIZATION RIM STEP 13D 














D. IF THERE WERE NO VALID EXITS FOUND, \IHARTSD 


FREES THE EXIT TABLE AND CLEARS THE / 
POINTER TO IT RTSDEXTB 


E. IF SOME VALID EXITS WERE FOUND, CLEARS \IHARTSD 


THE LAST ENTRY OF THE TABLE / 
RTSOEXIT 


DELETES MODULE IEAVTSXT 


GETHAINS THE OUTPUT BUFFERS, 


CCWS AND IDAWS FOR FULL 
TRACK WRITES. 





IHASDWRK pc > FINDS THE LARGEST DASD TRACK \IHASDURK 
CAPACITY / 
IHASDWRK J ---------- > GETMAINS STORAGE FOR FULL \IHASDWRK 








\ TRACK WRITE BUFFERS. / 


IHASDWRK 





THASDWRK See > GETMAINS STORAGE FOR THE 
\ CCWS AND IDAWS 

SDWCCWSR SDWCCH / 

SDWIDAW 


IHAS DWRK 


SDWRCMAX 


IHASDDAT \ CLEARS THE STORAGE FOR THE 
/ CCWS AND IDAWS 
SDDFTCCW 
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Diagram 41. SVC Dump Initialization (EAVNPDI) Part 12 of 12 
IEAVTSDI - SDUMP INITIALIZATION RIM STEP 20 
. 
20 > 


/ 
LOADMOD 


20| LOADS THE SPECIFIED MODULE 





IF SPECIFIED MOUDLE RESIDES 
IN THE HUCLEUS, ISSUES THE 
PUCLAUP MACRO TO OBTAIN THE 
CSECT ADDRESS 


A. IF MODULE SHOULD RESIDE IN FIXED COMMON 
STORAGE, ISSUES A LOAD TO GLOBAL STORAGE 
FOR THE CSECT 

B. ELSE ISSUES A LOAD FOR THE CSECT 

C. SAVES THE MODULE’S ADDRESS 

D. SAVES THE MODULE'S LENGTH 


IF THE MODULE IS NOT FOUND, \THANVT 
ISSUES MESSAGE IEA&83I 


/ 
RNVT 
RCVT 
[23] IF THE MODULE WAS FOUND, 


DELETES THE CDE 


24 > PROCESS THE DAE DEFAULT 
/ PARAMETER DATASET. 
LOADDFLT 





[25] LOADS MODULE ADYDFLT 
2 


‘\ 
\rn77 LOADMOD: 20 


ADYDFLM Se > 26 IF THE LOAD FAILED, DEFAULTS 


THE SIZE OF THE DFLH. 


GETMAINS SPACE FOR A COPY OF \ 
ADYDFLT / 


GETMAIN 


(RU) LV¢MODLEN) At DSCDFL) SP(239) 


ADYDSCA 


DSCDFL 





ADYDSCA 







\ \ADYDFLM 


/ / 
DFLID 


ADYDFLM 
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Diagram 42. Program Call/Authorization Initialization (IEAVNPFS5) Part 1 of 2 


[EAVNIPM (Step 29) 
Input Process Output 


EATTR 


1 invoke system address 
space initialization. 


(EEMB881 


System 
address space 


create routine 


Register 15 


Return code 2 Check for a successful 
initialization. 


® unsuccessful 


Register 15 








Abend code 
EAECB 
3 Wait for PC/AUTH EAERIMWT 
initialization to complete. 


Return 
to caller 
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Diagram 42. Program Call/Authorization Initialization (TEAVNPFS) Part 2 of 2 


Extended Description Module Label 


The program cal!!/authorization RIM creates the PC/AUTH 

address space and initializes it, including the control blocks 
and tables necessary to allow cross memory communication 
among address spaces to take place. 


1 Initialize the attribute list (EATTR) that describes the \EAVNPFS 
attributes of the PC/AUTH address space: it is to be 
exempt from system non-dispatchability (that is, it is to be 
in timited function start mode), it cannot be terminated 
even for DAT errors, and it is to be used for data only. 
Invoke the system address space create routine (IEEMB881), 
Passing the attribute list as input. Indicate on the call to 
IEEMB881 that the PC/AUTH address space initialization 
routine, |EAVXMAS, is to get control to initialize the 
PC/AUTH address space after it is created. 
(IEAVXMAS is an example of system address space 
initialization, depicted in Diagram 39.) 


2  &xamine the return code from IE EMB881 to deter- IEAVNPF5 
mine if the address space creation was successful. If so, 

continue with step 3. If the return code indicates that the 

creation was not successful, then place the return code 

from register 15 in register 2, place the reason code from 

register O in register 3, and issue an ABEND with a code of 

X’053’. 


3 = With address space initialization underway, issue the IEAVNPF5 
WAIT macro instruction to wait until IEAVXMAS 

finishes initializing the PC/AUTH address space. 

IEAVXMAS will post the ECB IEAVNPF5 is waiting on 

(EAERIMWT) to indicate that the PC/AUTH address space 

is initialized. IEAVNPF5 then returns to its caller. 


Recovery Processing 


None. 
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Diagram 43. Program Call/Authorization Address Space Initialization (IEAVXMAS) Part 1 of 8 


Started Task Control 
Processing {(i/EEPRWI2) 













Input Process 
1 
CVTXSFT PSASVT 
SVT 
ee 
SVTNSLX 2 
FS Cs 
SFT 
3 
CMOD table 
[| 4 
Constants 
| 5 


Determine the PC/AUTH 
ABEND routine entry 
point. 


Calculate the amount of 
storage required for PC/ 
AUTH control blocks and 
tables. 


Obtain storage for PC/ 
AUTH control blocks and 
tables. 


Initialize the system 
linkage table. 


initialize the PC/AUTH 
entry table and the latent 
parameter areas. 


6 Initialize the system 





authorization table. 


c 


Output 


System linkage table 









PC/AUTH entry table 





PC/AUTH latent 
Parameter areas 


System authorization table 


System linkage table 


PC/AUTH entry table 


Latent parameter areas 


7} 


System authorization table 


00110000.... 
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Diagram 43. Program Call/Authorization Address Space Initialization (IEAVXMAS) Part 2 of 8 


Extended Description Module 


PC/AUTH address space initialization is an example of 
model system address space initialization routine (depicted 
in Diagram 61). IEAVXMAS initializes the PC/AUTH 
address space in response to a request from the PC/AUTH 
RIM, \EAVNPF5 during NIP. This initialization includes 
obtaining and initializing the PC/AUTH control blocks and 
tables required for the PC/AUTH address space. 
IEAVXMAS also initializes other control information for 
other existing address spaces so that PC/AUTH services can 
be used during the remainder of NIP processing. 


Input to IEAVXMAS consists of: 


@ The ECBs ({EZEAECB) used to communicate between 
1}EAVNPFS5 and 1EAVXMAS during PC/AUTH address 
space initialization, 

@ The address of the system address space initialization 
WAIT/POST routine, IEEMB883, which IEAVXMAS 
uses to complete the PC/AUTH address space initializa- 
tion and wait for master scheduler initialization to 
complete. 

e@ The PC/AUTH ASCB. 


Other control blocks and tables accessed by IEAVXMAS 
include: 


e Asystem function table (SFT) identifying the PC/ 
AUTH entry tables. 

e A CMOD table identifying the PC/AUTH services cor- 
responding to the PC/AUTH entry table entries. 

e An address space second table entry (ASTE} pointed to 
by the PC/AUTH ASCB. 

e A supervisor vector table (SVT) for indicating to the 
other system components that PC/AUTH services are 
available and active. 


1 Invoke the PC/AUTH nucieus entry point search 

routine, IEAVXEPM, to determine the PC/AUTH 
ABEND routine entry point address. If IEAVXEMP 
returns a non-zero return code, issue an ABEND with code 
X ‘053’ and an appropriate reason code. If IEAVXEPM 
returns a zero return code, then the PC/AUTH ABEND 
routine’s entry point address is in register 2 and is saved for 
later use. 


IEAVXEPM 


Label 


Extended Description Module Label 


2 Determine the number of PC/AUTH entry indexes, IEAVXMAS 
the highest linkage index in the SFT, and the highest 

possible system linkage index. If the highest linkage index 

in the SFT is too high, issue an ABEND with code X‘053’, 

and an appropriate reason code; otherwise calculate the 

amount of storage needed for the system linkage table, 

PC/AUTH entry table and latent parameter areas, and the 


system authorization table. | 


3 = Issuea GETMAIN macro instruction to obtain storage 

from subpool 255 for the system linkage table, PC/ 
AUTH entry table and iatent parameter areas, ana the sys- 
tem authorization table. 


4 Initialize the system linkage table by setting all the 

linkage table entries invalid. Then initialize the appro- 
priate linkage table entry for the PC/AUTH entry table. To 
initialize the entry, mark it as valid and set it to point to 
the PC/AUTH entry table. 


f Use the CMOD table and constants within this module 
to initialize the PC/AUTH entry table and latent 
parameter areas. Issue the LOAD macro instruction to load 
the PC/AUTH load module, IEAVXPCA. IEAVXPCA per- 
manently resides in the PC/AUTH address space and con- 
tains the PC/AUTH service routines. The CMOD table con- 
tains the entry point names of the various PC/AUTH serv- 

ices. Issue the LOAD macro instruction for each entry 
point name. For each address returned from the LOAD 
macro instruction, initialize a PC/AUTH entry table entry 
and its corresponding latent parameter area. 


G Set the systam authorization table to its base state, 
identifying authorized and unauthorized authorization 
indexes. 
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Diagram 43. Program Call/Authorization Address Space Initialization (IFAVXMAS) Part 3 of 8 


Input Process 


J Obtain storage for a link- 


10 


11 


age index allocation 
table (LXAT), authori- 
zation index allocation 
table (AXAT), across 
memory directory 
(XMD), and an entry 
table information block 
(ETIB). 


Initialize the XMD. 


Initialize the AXAT. 


Initialize the PC/AUTH 
ETIB. 


Initialize the LXAT. 


Output 


LXAT 





XMD 


AXAT 


ETIB 
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Diagram 43. Program Call/Authorization Address Space Initialization (IEAVXMAS) Part 4 of 8 


Extended Description Module Label 


7 Determine the amount of storage required for a link- 

age index allocation table (LXAT), an authorization 
index allocation table (AXAT), e cross memory directory 
(XMD), and an entry table information block (ETIB). Ac- 
quire the local lock and issue a GETMAIN macro instruc- 
tion to obtain this storage from subpool 229; then release 
the local lock, Performing a GETMAIN in this way ensures 
that the storage will be associated with the RCT so that the 
AXAT and LXAT can be freed by PC/AUTH service rou- 
tines. 


8 _—siInitialize the XMD. The XMD contains data for all PC/ 
AUTH services, 


Q Indicate in the AXAT that authorization indexes of 0 
and 1 are owned by the PC/AUTH address space. 


1Q The ETIB contains pointers to the entry table it de- 

scribes, the latent parameter areas for that entry table, 
and other information such as the owning ASCB and entry 
table attributes. 


11. Indicate in the LXAT that all linkage indexes reserved 

in the SFT are system linkage indexes and are owned. 
Initially, all linkage indexes contained in the SFT are 
marked as being Owned by the PC/AUTH address space. 
When another address space performs the entry table con- 
nect for a system linkage index, that address space becomes 
the owner of the linkage index. 
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Diagram 43. Program Call/Authorization Address Space Initialization (IEFAVXMAS) Part 5 of 8 


12 Perform PC/AUTH initial- 
ization for the other 
address spaces that exist. 


Input Process 





13 Initialize the pointer in 
the SVT to point to the 
PC/AUTH ASCEB and 
initialize relevant fields 
in the PC/AUTH ASCB. 


14 Initialize the PC/AUTH 
ASTE. 


15 (Indicate that PC/AUTH 
services are now operable. 





iEAVEBBR 


Bind break 
routine 





Output 


ASCB 







PC/AUTH ASCB 


PC/AUTH ASTE 


ASTE 


SVTASCB 


SVTXMSOP 
SVTXMSUP 
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Diagram 43. Program Call/Authorization Address Space Initialization (IEA VXMAS) Part 6 of 8 


Extended Description Module Lahel 


12 Perform the following for each address in the ASVT 


except the current one. 


Set the AX to Oor 1 if the ASID=1. 

Set up to use the system linkage table. 

Set up to use the system authorization table. 

Reset the ASTEICMA field. (When any ASTE is created, 
ASTEICMA is set on to prevent cross memory accesses 
before the other fields of the ASTE are initialized.) 


Invoke the bind break routine (IEAVEBBR) to perform re- iIEAVEBBR 
translation by initializing the control registers of any active 

address spaces so that they can use PC/AUTH services. If 

the return code from IEAVEBBR is not zero, ABEND with 

a code of X‘053’. 


13 Indicate in the PC/AUTH ASCB the number of autho- IEAVXMAS 


rization indexes, linkage indexes, and entry tables 


owned and the virtual addresses of the system authorization 
table and system linkage table. Chain the PC/AUTH ASCB 
to the SVT. 


14 Perform the following for the PC/AUTH ASTE: 


Set the authorization index to 1. 

Set up to use the system linkage table. 

Set up to use the system authorization table. 

Reset the ASTEICMA field after the other fields have 
been updated. 


15 Turn bits SVTXMSOP and SVT XMSUP on to indicate 


that PC/AUTH services are available. 
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Diagram 43. Program Call/Authorization Address Space Initialization (IEAVX MAS) Part 7 of 8 


Input Process Output 









IEAVXSTD 






([EAVECMS 


CALLDISP 


System entry 
table descriptor 








16 Create the system entry 
table (SET) and connect 
it to every address 

space. 


___ 


IEAVXECR 


ETCRE 


fEAVXECO 


ETCON 












17 Post I|EAVNPFS5 to allow 
NIP processing to con- 
tinue. 


EAECB 


EAERIMWT 





Register 1 
IEEMB883 


System address 
space initializa- 
tion WAIT/ 

POST routine 










18 Wait for master scheduler 


initialization to complete. Parameter list 


4 ASCB 


4 Event code 


19 Enter a never-ending wait. 
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Diagram 43. Program Call/Authorization Address Space Initialization (IEAVXMAS) Part 8 of 8 


Extended Description Module Label 
16 Issue the CALLDISP macro instruction to retranslate lEAVECMS 

the control registers for the processor on which 
{JEAVXMAS is active. Using the system entry table IEAVXECR 


descriptor ((EAVXSTD) in module IEAVXSEM as input, 

issue the ETCRE macro instruction to create the system 

entry table (SET). To connect the system entry table to \EAVXECO 
all address spaces, issue the ETCON instruction macro. 


17 Post the PC/AUTH RIM, [EAVNPF5, using the ECB 
named EAERIMWT, tp permit NIP processing to 
continue. 


18 Cail the system address space intitialization WAIT/ IEEMB883 
POST routine, |EEMB883, to indicate that control 

should be returned when master scheduler initialization 

has completed. Invokes /EEMB883 in order to allow the 

master scheduler to fully initialize PC/AUTH’s control 

blocks, such as the pointer in the TCB to the TIOT, which 

will be thé master scheduler’s TIOT. Pass to |EEMB883 

a parameter list containing the PC/AUTH ASCB address 

and the event code address. 


19 When IEEMB883 returns, enter a never-ending wait. IEAVXMAS 
(The PC/AUTH address space is thus in limited func- 
tion start mode.) 


Recovery Processing 


None. 
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Diagram 44. System Trace Initialization (IEAVNPS51) Part 1 of 2 


IEAVNIPM. 
(Step 30) 


Input 






SA 
PSATBVTV 
PSATRVT NIP TBVT 


TBVTBKWD 

TBVTENTY 
TRVTTOB 

TBVTNXTV 


TBVTBUFV 
TBVTBST 


TBVTCRIZ 


TOBASID 


NIP TBUF 


Process 


1 Create and initialize 
the system trace 
address space. 


2 Copy the contents of 


NIP buffers into 
trace buffers. 


a. Set up serialization 
and addressability 
for NIP and trace 
TBVTs and buffers. 


b. Copy as much NIP 
trace data as possible. 


c. Restore addressability 
and serialization. 


d. Free storage used 
by NIP TBVTs and 
buffers. 


IEAVNIPM 





Output 


PSATBVTV 
Trace TBVT 


TBVTBST 


TBVTENTY 


TBVTBUFYV 


¢ Trace TBUF 
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Diagram 44, System Trace Initialization (IEAVNPS51) Part 2 of 2 


Extended Description Module 


LEAVNIPM calls the system trace RIM, IEAVNP51, to create 
the system trace address space and initialize the trace function. 


1 +The trace RIM calls the alter trace environment service IEAVNP5S1 
(ALTRTRC) to initialize the trace address space and 

initialize the trace function. It checks the return code from 

ALTRTRC. If the return code is X’0’, processing continues. 

Otherwise, ALTRTRC did not initialize the trace function, 

and the system enters a wait state with a code X‘151’. For 

more information on the ALTRTRC service, see the system 

trace section in System Logic Library. 


2 = Thetrace RIM preserves the most recent data from NIP 
buffer vector tables (TBVTs) and buffers (TBUFs) by 
copying the most recent NIP trace data to the system trace 
TBVTs and buffers. Note that the NIP TBVTs and buffers 
are in the system queue area (SQA) and that the trace TBVTs 
and buffers are in the private area of the trace address space. 


If NIP has not created a trace structure for NIP tracing (that 
is, PSATBVTV = 0), the trace RIM returns to IEAVNIPM. 


lf NIP has created a trace structure for NIP tracing (that is, 
PSATBVTV was non-zero to entry), then the trace RIM 
proceeds as follows: 


a. Toprevent the loss of any trace entries, the trace RIM 
calls the PGSER service to fix the pages this module 
occupies and obtains exclusive use of the trace spin 
lock for disablement and serialization on the TBVT 
queue, To obtain access to the trace data, it issues the 
ESAR instruction to set up secondary addressability to 
the trace address space. (TOBASID gives the ASID of 
the trace address space.) The trace RIM invokes 
ALTRTRC to suspend recording of system events 
before the trace RIM copies the trace data. If ALTRTRC 
was unable to suspend recording system events, the 
trace RIM returns control to IEAVNIPM. 


Extended Description Module Label 


b. The trace RIM loops through the NIP TBVT queue. 


Starting with the most recent NIP TBVT, it copies trace 
data information from each NIP data buffer and NIP 
TBVTs into the new trace buffers (addressed by 
PSATBVTV) and trace TBVTs. If there is more NIP 
data than the system TBVTs and buffers can hold, then 
the earliest NIP trace data is lost. TBVTBUFV and 
TBVTENTY identify the start and end address of the 
area the trace RIM copies. TBVTPREV and TBVTNEXT 
are the forward and backward pointers for the TBVT 
queue. 


The trace RIM calis the ALTRTRC service to resume 
recording system events and resets secondary address- 
ability to that entry. It issues aSETLOCK macro 
instruction to release the trace spin lock to enable for 
interrupts and release the serialization. 


. The trace RIM issues a FREEMAIN macro instruction 


to release the SQA areas that NIP used for its TBVTs 
and buffers and returns to [EAVNIPM with a return 
code of zero. 
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Diagram 45. Glohal Resource Serialization Trigger Address Space Creation (IFAVNP33/ISGNTASC) Part 1 of 2 


IEAVNIPM (Step 31) 


Input Process Output 
















1 Create and initialize 
the global resource 

serialization address 
space. 


\EEMB881 


System address 
space create 
routine 


Register 1 





EAECB 


EAERIMWT 








Register 2 








2 Wait for the 
initialization to 
complete. 





IEAVNIPM 
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Diagram 45. Glohal Resource Serialization Trigger Address Space Creation (IEAVNP33/ISGNTASC) Part 2 of 2 


Extended Description Module 


ISGNTASC is the second global resource serialization RIM 
to get control and starts the creation of the global resource 
serialization address space. ISGNTASC receives control 
from [EAVNIPM in supervisor state and in key zero. 
IEAVNIPM uses the standard interface to RIMs. 


e Register 2 contains the address of the NIP vector table 
(NVT). 

@ Register 3 contains the address of the communications 
vector table (CVT). 


Note that IEAVNIPM knows ISGNTASC as IEAVNP33. 
ISGNTASC is an entry point in load module |EAVNP33. 


1 Build the three-word parameter list to pass to the iIEEMB881 
system address space create routine (/EEMB881). 

The first word of the parameter list points to the system 

address space initialization attributes (The address space is 

exempt from system non-dispatchability and termination. 

It has the highest possible dispatching priority, it is non- 

swappable, non-cancellable, and non-forceable; and its 

page fixes are in preferred storage.) The second word points 

to the program name (ISGNASIM} to receive control from 

IEEPRWI2 in order to initialize the address space with global 

resource serialization information. ISGNASIM is an example of 

a model address space initialization routine depicted in diagram 

56. The third word points to the length and character string 

containing the START parameters. 


Call IEEMB881 to create the address space. If systern 
address space creation is successful, IEEMB881 returns 
the ASCB address in register 1 and the address of the ECB 
(EAERIMWT) in register 2. 


2 Issue a WAIT on the ECB provided by IEEMB881 

(EAERIMWT). ISGNASIM will post the ECB when 
the global resource serialization address space has been 
completely initialized. 


ISGNTASC then returns to JEAVNIPM. 


Recovery Processing 


None. 


Label 
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Diagram 46. Global Resource Serialization Trigger Address Space Initialization (ISGNASIM) Part 1 of 12 
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blocks. 


3 Obtain and initialize a page 
release SRB. 
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Diagram 46. Glohal Resource Serialization Trigger Address Space Initialization (ISGNASIM) Part 2 of 12 


Extended Description Module 


ISGNASIM initializes the global resource serialization ad- 
dress space so that the global resource serialization services 
of the system will be operational. |SGNASIM is an example 
of model system address space initialization (depicted in 
Diagram 61. Input to ISGNASIM is a parameter list 
containing: 


e@ The address of the ASCB for the global resource seriali- 
zation address space. 

@ The address of an ECB to use to inform globa! resource 
serialization trigger address space creation module, 
ISGNTASC, that the global resource serialization 
address space has been initialized. 

e@ The address of the system address space initialization 
WAIT/POST routine, |EEMB883, used to wait until 
master scheduler initialization is complete. 

1 Establish a cross memory environment by using the ISGNASIM 

ETCRE, AXSET, and ETCON macro instructions. 
First, build an entry table description (ETD) for each service: 


e ENQ/DEQ/RESERVE. 

e ENQ/DEQ/RESERVE (SQA QWB overflow). 

@ Global resource serialization termination resource manager. 

e Fast path DEQ. 

@ Fast path ENQ. 

e Global resource serialization SVC dump services. 

@ Queue scanning services (for SCOPE=STEP, SYSTEM, 
and SYSTEMS), 

@ Queue scanning services (for SCOPE=LOCAL or 
GLOBAL). 


e Mainline ESTAE. 
e ENQ/DEQ/RESERVE mainline FRR. 
e@ Global resource serialization storage manager. 


From the system function table (SFT), save the program call 
number of the following services in the global resource 
serialization vector table (GVT). 


Global resource serialization SVC dump services. 
ENQ/DEQ/RESERVE. 

ENQ/DEQ/RESERVE (SQA QWB overflow). 

Mainline ESTAE. 

ENQ/DEQ/RESERVE mainline FRR. 

Fast path ENQ. 

Fast path DEQ. 

Giobal resource serialization storage manager. 

Global resource serialization termination resource manager. 
ENQ/DEQ resource manager. 


Label 


Extended Description Module Label 


After creating all ETDs, issue an ETCRE macro instruction 
to create the entry table, issue the AXSET macro instruction 
to set the authorization index for the global resource seriali- 
Zation address space, and issue the ETCON macro instruction 
to connect the global resource serialization entry table to 

the proper Jist of linkage index values. Other address 

spaces can now access the global resource serialization 
services defined in the entry table. 


2 Calculate the amount of storage needed for the re- ISGNASIM 
source queue area (RQA), the extended resource queue 
area (ERQA), a bit map and the ERQA describing the ROA, 


and the following contro! blocks: 


e@ Global resource serialization vector table extension 
(GVTX). 

Local queue hash table {LQHT). 

Global queue hash table (GQHT). 

Local resource poo! table (LRPT). 

Global resource poo! table (GRPT). 

System/ASID hash table {SAHT). 


Issue the GETMAIN macro instruction with the LOC=(BE LOW, 
ANY ) operand to obtain this storage from subpoo}! 229. 

Clear the storage containing the control blocks and the bit 
maps and issue the PGFIX macro instruction to fix al! the 
pages describing this storage. Issue the GETMAIN macro 
instruction to obtain storage for the RQA from subpool 

229. Issue the GETMAIN macro instruction with the LOC= 
(ANY, ANY) operand to obtain storage for the ERQA from 
subpool 127. Finally, issue the GETMAIN macro instruction 
for SQA storage (subpool 245) to obtain permanent storage 
for the queue work block (QWB). This storage is not 

cleared. The permanent QWB will describe local resource 
requests within the global resource serialization address space. 


3 Obtain SOA storage (subpool 245) for an SRB. The 
global resource serialization storage manager schedules 
this SRB to release pages fixed no longer needed in the 
resource queué area step 2 because the serialization required 
for a page release cannot be obtained in cross memory made. 
GVTSPRLS contains the entry point address of the routine 
that will perform the page release. The SRB is initialized with: 


@ The address in the GVTSPR_LS field of the GVT. 

@ An FRR address from GVTGFRRO in the GVT. 

e@ The address of the global resource serialization address 
space ASCB and its ASID. 

e@ The address of a resource manager routine (BR 14). 
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Diagram 46. Global Resource Serialization Trigger Address Space Initialization (ISGNASIM) Part 3 of 12 


Input Process 
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Diagram 46. Global Resource Serialization Trigger Address Space Initialization (ISGNASIM) Part 4 of 12 


Extended Description Module Label 


Issue the LOAD macro instruction to load ISGNASIM 
ISGGQWBC, the QWB copy routine into the global 

resource serialization address space, and save its address. The 

address is stored later in the GVT. The QWB copy routine is 

used to extract information from the RSA-message. 


To prepare to copy the control blocks, obtain the ISGNASIM 
local lock for the global resource serialization address 

space and the CMS ENQ/DEQ lock. These locks serialize the 

use of the GVT, GVTX, and other local control blocks in the 

global resource serialization address space. 


Store in the GVT, the address of the QWB copy routine that 
resides in the global resource serialization address space. Save 
the address of the SQA version of ISGQWBC. Use this 
address to release the storage later. 


Initialize the GVTX in the global resource serialization 
address space's private area. Store in the GVT X the address 
of the page release SRB. Put the address of the ROA and its 
size into the GVTX. Put the address of the ERQA andi its 
size into GVTX. Save the RQA and ERQA bit map address 
in the GVTX. Build and format the LQHT and LRPT and 
store their addresses in the GVTX. Store the address of the 
new permanent QWB inthe GVT. (Save the address of the 
old permanent QWEB so its storage can be released later.) 
Copy all queue contro! blocks (QCBs)}, queue elements 
(QELs), and queue extension blocks (QXBs) from the SQA 
RQA to the ERQA in the global resource serialization ad- 
dress space’s private area. Use the storage manager routine, 
ISGSALC, to obtain QCB, QEL, and QXB cells as needed 
during the copy process. Use the global/local hash routine 
(ISGGHASH) to obtain indexes into the LQHT for the new 
QCBs. Format the GQHT, GRPT, and SYSID/ASID hash 
table (SAHT) in the private area of the global resource 
serialization address space and save their addresses in the 
GVTX. 
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Diagram 46. Global Resource Serialization Trigger Address Space Initialization (ISGNASIM) Part 5 of 12 


Input Process Output 
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ee 














Indicate that the global 
resource serialization 
address space initialization 
is complete. 





GVT 
reer 
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ee 
GVTGRSAS=1 







Input parameter list 
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SVC table 
___CSCSC—S 


4 ISGLDQOO 
pe 
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pe 






7 Update SVC table entries 
through the NIPSVCUP 
macro. 
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SCVTSCVT 













SVC table 
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release 
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8 Release temporary 
storage. 
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Diagram 46. Glohal Resource Serialization Trigger Address Space Initialization (ISGNASIM) Part 6 of 12 


Extended Description Module Label 


6 Place the ASCB address passed as input into the GVT. ISGNASIM 
The ASCB is the one for the global resource serializa- 

tion address space. Then indicate that the global resource 

serialization address space is initialized (GVTGRSAS='1'). 


Update the SVC table entries through the ISGNASIM 
NIPSVCUP macro for ENQ and DEQ so that control 

is NOW given to the fast path DEQ function (entry point 

ISGLDQOO) and the fast path ENQ function (entry point 

ISGLNQO0) with AMODE(31). These SVC table entries 

are initialized at this time because these fast path functions 

require the global resource serialization address space to be 

initialized. After initializing the SVC table entries, release 

CMS ENQ/DEQ lock and the local lock of the global re- 

source serializatinn address space. 


8 Release temporary storage acquired by ISGNCBIM, ISGNASIM 
which initialized global resource serialization control 

blocks used by local services before the creation of the global 

resource serialization address space: 


e Release the entire RQA in SQA unless one or more QWB 
cells are allocated, in which case, only release the ROA 
storage that doesn’t include the QWB pool of storage. 

e Release global resource serialization contro! blocks in SQA. 

e Release the old permament QWB storage in SQA. 

e Release the SQA version of ISGGQWBC. 


All this storage is released by issuing the FREEMAIN macro 
instruction for SQA (subpool 245). 
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Diagram 46. Global Resource Serialization Trigger Address Spacc Initialization (ISGNASIM) Part 7 of 12 


Input Process 
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resource serialization 
service routines. 






GVTGVTX 


10 Request notification 
of timer and console 
services. 






Input 
parameter list 





11 Notify ISGNTASC that 
the global resource 
serialization address space 
is initialized. 






12 Establish recovery for 
global resource 
serialization command 
processing. 
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Output 
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Diagram 46. Global Resource Serialization Trigger Address Space Initialization (ISGNASIM) Part 8 of 12 


Extended Description Module 

9 Issue the LOAD macro instruction for the global ree ISGNASIM 
source serialization service routines located in the 

ISGGSRV0O load module. Call ISGGSRVI to place the ISGGSRVI 


entry point addresses of the various service routines into 
the GVTX. 


Issue the LOAD macro instruction to load ISGNPGIM ISGNASIM 

into CSA storage. Build a parameter list for the event 
notification facility (ENF) and invoke the ENF 
(IEFENFFX) to establish ISGNPGIM as the “‘listener’’ for 
the availability of timer and console services. (Timer and 
console services are needed in order to process global 
resource requests.) The event notification facility invokes 
ISGNPGIM when timer and console facilities become 
available. The parameter list indicates: 


IEFENFFX 


@ A listen request. 

e ISGNPGIM as the listener. 

e@ An event code indicating timer and console services 
availability as the event. 


If ISGNPGIM is not established as the “‘listener’’ 

(the return code from IEFENFFX is not zero} then issue 

an ABEND macro instruction with a system completion code 
of X‘09A'. (A specific reason code identifies the nature of 
the error.); if ISGNPGIM is established at the ‘‘listener’’, 
then continue with step 11. 


Label 


Extended Description Module 


Using the ECB passed in the input parameter list, issue !SGNASIM 
the POST macro instruction in order to notify global 

resource serialization address space creation, ISGNTASC, 

that the address space has been initialized. ISGNTASC can 

then finish its processing. 


12 Load the recovery routine required by the command 
processing modules and the message module. Then 
establish recovery for ISGNASIM. Specifically. 


@ Load ISGCRCV and store the entry point address in the 
GVTX (GVTXCRCV). 

@ Load ISGMSGOO, message module, and store the entry 
point address in the GVTX (GVTXMSG). 

@ Establish ISGCRCV as an ESTAE for ISGNASIM. If 
establishing the ESTAE was unsuccessful, issue an ABEND 
with a system completion code of X‘09A’ and a reason 
code identifying the specific nature of this error. 
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[Magram 46. Global Resource Scrialization Trigger Address Space Initialization (ISGNASIM) Part 9 of 12 
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Diagram 46. Global Resource Scrialization Trigger Address Space Initialization (ISGNASIM) Part 10 of 12 


Extended Description Module 


13 Using the ECB in the GVT (GVTNECB), issue the ISGNASIM 
WAIT macro instruction in order to wait until timer 

and console services are available. ISGNPGIM, established 

as the “listener’’ for the availability of timer and console 

services in step 10, posts this ECB when these services are 


available. 


Once ISGNPGIM posts GVTNECB, ISGNPGIM is no longer 
needed at ‘the listener’ for the availability of timer and 
console services (they are now available). Invoke the event 
notification facility (IEFENFFX) to delete ISGNPGIM asa 
‘listener’ for these services. Upon return from IEFENFFX, 
issue the DELETE macro instruction to delete ISGNPGIM 
from storage. 


[EFENFFX 


14 Issue the ATTACH macro instruction for the global 
resource serialization wait for master scheduler initiali- 

zation routine (ISGNWMSI), passing the address of the 

system address space initialization WAIT/POST routine 

(IEEMB883). If the attach is successful, ISGNWMSI, exe- 

cuting as a subtask, will invoke IEEMB883 in order to 

determine when master scheduler initialization completes. 

If the attach is unsuccessful, issue an ABEND with a system 

completion code of X‘09A‘ and a reason code identifying 

the specific nature of the error. 


ISGNASIM 


15 ‘Issue the ATTACH macro instruction for the global ISGNASIM 
resource serialization command router (ISGCMDR), 

passing the ECB, GVTXECBO. Issue the ATTACH macro 

instruction for the global resource serialization resource 

processor (ISGGRPOO), passing the ECB, GVTXECBZ2. If 

either ATTACH is unsuccessful, issue an ABEND with a 

system completion code of X‘09A’ and a reason code identi- 

fying the specific nature of the error. If both are successful, 

issue a WAIT macro instruction for the ECB list containing 

GVTXECB1 and GVT XECB2. 


e@ GVTXECBO indicates whether ISGCMDR finished pro- 
cessing normally or abnormally. 

e@ GVT XECB1 indicates whether ISGGRPOO finished its 
initialization successfully or unsuccessfully. 

e GVTXECB2 indicates whether ISGGRPOO finished its 
processing normally or abnormally. 


Label 


Extended Description Module Label 


lf GVTXECB1 and GVT XECB2 do not indicate that 
ISGGRPOO completed successfully, issue an ABEND with a 
system completion code of S’OQ9A’ and a reason code identi- 
fying the specific nature of the error. GVT XECBO is checked 
in step 17. 


16 _ If the GRS system parameter was specified as JOIN ISGNASIM 
(GVTJOIN = 1) or START (GVTSTART = 1), issue 

the ATTACH macro instruction, for the global resource 

serialization CTC ring processor (ISGBTC}) passing the ECB, 

GVTXECB4, In addition, issue the ATTACH macro 

instruction for the global resource serialization option 

processor (ISGNGRSP) passing the ECB, GVTXECB5. 

Issue an ABEND with a system completion code of 

X’O9A’ and an appropriate reason code if either ATTACH 

is unsuccessful; otherwise, issue the WAIT macro 

instruction for the list of ECBs, GVTXECB3, 

GVTXECB4. and GVT XECBS5. 


e GVT XECB3 indicates whether ISGBTC finished its 
initialization successfully or unsuccessfully. 

e GVTXECB4 indicates whether ISGBTC finished pro- 
cessing abnormally or normally. 

@ GVT XECBS5S indicates whether ISGNGRSFP finished 
processing abnormally or normally. 


Issue an ABEND with a system completion code of X‘09A' 
and an appropriate reason code if GVT XECB3 or 
GVTXECB4 indicate unsuccessful ISGBTC processing or 

if GVTXECB5S indicates unsuccessful ISGNGRSP processing. 
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Diagram 46. Glohal Resource Serialization Trigger Address Space Initialization (ISGNASIM) Part 12 of 12 


Extended Description 


17 In an infinite loop, perform the following processing: 


a. Issue a WAIT macro instruction for four ECBs: 


GVTXECBO, GVTXECB2, GVTXECB4, and 
GVTXECBS. 


e GVT XECBO indicates whether the processing of 
ISG CMDR ended normally or abnormally. 

e GVT XECB2 indicates whether the processing of 
ISGGRPOO ended normally or abnormally. 

e GVT XECB4 indicates whether the processing of 
ISGBTC ended narmally or abnormally. 

e GVT XECBS5 indicates whether the processing of 
ISG NGRSP ended normally or abnormally. 


b. When any of the four ECBs are posted, determine 


which ECB was posted. If GV TXECBO was posted, 
check to see if ISGCMDR completed successfully. If 
not, issue a DETACH macro instruction to detach 
ISGCMDR,, clear GVT XECBO, and issue the 
ATTACH macro instruction to reattach [SGCMDR 
as a subtask. If this reattach is unsuccessful, process 


the command request queue, terminating each request- 


er, and finally issue an ABEND with system comple- 
tion code of X’09A’ and a reason code identifying 
the specific nature of the error. 


If the reattach is successful, check the processing 
status of the global resource processor, ISGGRPOO. 
Check the ECB, GVTXECB2, to see if ISGGRPOO 
processed successfully. If ISGGRPOO processed 
successfully, issue the DETACH macro instruction to 
detach ISGGRPOO and release GQWA and GGSA 
storage. If ISGGRPOO was unsuccessful, issue an 
ABEND with system completion code of X‘09A’ and 
a reason code identifying the specific nature of the 
error. 


Check the processing status of the CTC ring processor 
task, ISGBTC, using the ECB, GVTXECB4. If 
ISGBTC was unsuccessful, issue an ABEND with a 
system completion code of X’‘09A’ and a reason code 
identifying the specific nature of the error; otherwise, 
continue checking the processing status. 


Module 


ISGNASIM 


Label 


ISGNASR2 


Extended Description Module Label 


Check the ECB, GVTXECBS, to determine the 
processing status of the global resource serialization 
option processor, ISGNGRSP. Issue an ABEND with 
system completion code of X‘09A’ and a reason code 
identifying the specific nature of the error if 
ISGNGRSP was unsuccessful; otherwise, continue the 
infinite loop by proceeding back to the beginning of 
this step to issue the WAIT macro instruction for the 
four ECB: GVTXECBO, GVTXECB3, GVT XECB4, 
and GVT XECBS. (Clear these ECBs before issuing 
the WAIT.) 


Recovery Processing 


A recovery section of ISGNASIM, starting at entry point 
ISGNASRYV provides the primary recovery. The ESTAE, 
ISGCRCV (established in step 12), initially intercepts the 
error and passes control to ISGNASRV. ISGNASRV deter- 
mines where the error occurred and whether a retry is possi- 
ble. If aretry is possible, ISGNASRV attempts the retry. In- 
put to ISGNASRV is: 


@ The address of the GVT. 
@ The address of the GVTX. 


Output from ISGNASRV is: 


@ Message ISGO10E, if the GRS system parameter is JOIN or 
START (1SGMSGOO is used to print the message and the 
message has not already been issued.) 

@ A reinitialized ECB used to check processing status at the 
point where retry is to be attempted. 

e An indication whether retry is to be attempted or not. 


Then, ISGNASRV returns to its caller. 


Notes: 


e Each ABEND issue by ISGNASIM with the system com- 
pletion code of X‘09A’ has a unique reason code associated 
with it. The reason code indicates the specific error that 
occurred in ISGNASIM. 

e@ The never-ending wait keeps the global resource serializa- 
tion address space from termination; it is in limited 
function start mode. 
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Diagram 47. Post Global Resource Serialization Initialization (ISGNPGIM Part 1 of 2 
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Diagram 47. Post Glohal Resource Serialization Initialization (ISGNPGIM Part 2 of 2 


Extended Description Module Label 


ISGNPGIM uses a cross memory post to notify ISGNASIM 
that timer and console services are available. 


The event notification facility invokes ISGNPGIM when the 
timer and console services are available. ISGNPGIM exe- 
cutes in key zero and in supervisor state. 


1 Issue the POST macro instruction passing the address ISGNPGIM 
of ISGNPRET the routine to be given control when an 

error condition results during POST processing. The 

ISGNPGIM post notifies the global resource serialization 

address space initialization module (ISGNASIM) that timer 

and console services are available. 


Recovery Processing 


If the POST issued in step 1 fails, ISGNPRET. issues a 
CALLRTM macro instruction to abend with a completion 
code of X’09A’ the task representing ISGNASIM, 
ISGNASIM’s recovery routine will subsequently get control 
to put the global resource serialization address space 

into a permanent wait state. 


(ISGNPRET is an internal entry point in ISGNPGIM, speci- 
fied on the ERRET keyword of the POST macro instruc- 
tion.) 
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Diapram 48. Global Resource Serialization Wait for Master Scheduler Initialization (ISGNWMSI) Part 1 of 2 
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Diagram 48. Global Resource Serialization Wait for Master Scheduler Initialization (ISGNWMSI) Part 2 of 2 


Extended Description 


ISGNWMSI waits for master scheduler initialization to com- 
plete. Global resource serialization address space initializa- 
tion (ISGNASIM) attaches ISGNWMSI to run in key O and 
in supervisor state, passing es input the address of the sys- 
tem address space initialization WAIT /POST routine 
(1EEMB883), the address of the global resource serializa- 
tion ASCB, and address of the ECB IEEMB883 uses to post 
completion of master scheduler initialization. 


1 Establish an ESTAE, ISGCRCV, so that a dump can 
be taken if IEEMB883 fails in its processing. 


2 Create the input parameter list for IEEMB883. The 
input parameter list contains: 


e@ The address of the global resource serialization ASCB. 

e The address of an event code; the event code indicates that 
ISGNWMSI is waiting for master scheduler initialization 
to complete. 


Invoke JEEMB883, passing the input parameter list. When 
|IEEMB883 returns, examine the return code. 


e if the return code is not zero, issue an ABEND with system 
completion code of X‘O9A' and a reason code indicating 
the IEEMB883 was unsuccessful. 

e If the return code is zero, indicating that IEEMB883 was 
successful, cancel the ESTAE recovery environment and 
return to the dispatcher as a completed task. 


Recovery Processing 


The ESTAE, ISGCRCV takes a dump when an error occurs 
while waiting for master scheduler initialization to complete. 


Module 


ISGNWMSI 


ISGNWMS! 


IEEMB883 


ISGNWMS! 


Label 
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Diagram 49. Global Resource Serialization Option Processor (ISGNGRSP) Part 1 of 10 
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Diapram 49. Global Resource Serialization Option Processor (ISGNGRSP) Part 2 of 10 


Extended Description Module Label 
iSGNGRSP processes the system parameter GRS=START 

or GRS=JOIN as part of the overall process of global 

resource serialization address space initialization. ISGNASIM 


attaches ISGNGRSP. 


e If GRS=START, then before this system can process 
global requests for resources, ISGNGRSP verifies 
that no other rings exist and that no error flags have 
been set. 

e If GRS=JOIN, ISGNGRSP invokes global resource 
serialization queue merge (ISGCQMRG) to get a copy 
of existing global resources that are held before per- 
mitting global requests from this system to be 
processed. 


lf errors occur during ISGNGRSP processing or if the GRS 
system parameter is inconsistent or invalid, ISGNGRSP 
prompts the operator for anew GRS option. 


e If the operator responds with GRS=NONE, ISGNGRSP 
invokes the STARTPOP (NONE) function (step 7). 

e If the operator responds with GRS=START or JOIN, 
ISGNGRSP again attempts option processing (step 2). 


After ISGNGRSP finishes its processing, contro! returns 
to the dispatcher to end the task, causing an ECB to be 
posted. ISGNASIM examines the ECB in order to 
determine whether or not to continue initializing the 
global resource serialization address space. 


1 Identify module, ISGCRCV, as the ESTAE routine. ISGNGRSP 


2 Steps 2-6 are performed until processing of GRS= 
START or GRS=JOIN is successful or until the 
operator switches the option to GRS=NONE (step 7). If an 
error occurs in steps 2-6 because of any calls to external 
routines, control passes to step 5 to issue an error 
message. Invoke ISGBCI, which invokes entry point 
ISGBRESN for the snapshot function to determine the 
status of other global resource serialization systems. 
1\SGBCI returns either information about other global 
resource serialization systems or an indication that there 


ISGBRFSN 
(SNAPSHOT) 


ISGBCI 


are none, 


Extended Description Module Label 


lf other systems exist, use the information about them 
in subsequent steps to determine whether or not the 
specified option (START or JOIN) for the GRS system 
parameter can be processed. Use this information also 
to determine the names of any other active global 
resource serialization systems. {f ISGBCI was unsuccessful, 
issue an ABEND with a completion code of X‘09A’ 

and a reason code identifying the snapshot failure. 

Also, issue message |SG007I to the operator indicating 
that the prompt option is to be used to restart the 
system or to reply “NONE”. If ISGBCI was successful, 
analyze the status of the system being started and of the 
systems that already exist. 


3 Check the GVT to see if the system parameter is 
GRS=START. If so, verify that start processing 
for the system still needs to be done. If it does, then 
continue with step 3a. If the system is started, then 
issue a message to the operator indicating that the 
system is started, cance! the ESTAE, and return to 
the caller. If GRS=JOIN was specified, proceed 
to step 4. 


ISGNGRSP 


a, If any other global resource serialization system 
exists or any error flags were set during the 
snapshot function of ISGBCI, then GRS=START 
is inconsistent with this environment. Set up 
message ISGOO5I with the appropriate informational 
message option related to this condition and go to 
step 5. 

b. If GRS=START is consistent with the environment, 
invoke the ring processing/command interface to 
start ring processing activities (STARTPOP, START) 
so that global resource requests can be processed. 

c. Indicate in the global resource serialization vector table 
(GVT) that global resource serialization option pro- 
cessing is complete (GVTGRSPC='1'). Prepare informa- 
tional message [SGOO4i and proceed to step 5. 


ISGBCI ISGBCFSP 


(STARTPOP) 
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Diagram 49. Global Resource Scrialization Option Processor (ISGNGRSP) Part 3 of 10 
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Diagram 49. Global Resource Serialization Option Processor (ISGNGRSP) Part 4 of 10 


Extended Description Module Label 


4 Verify that join processing for this system still needs ISGNGRSP 


to be done. If join processing needs to be done, con- 


tinue with step 5a. If the system is already joined, then 
broadcast to all systems in the ring that a new system 
has joined, cancel the ESTAE, and return to the caller. 


if no active global resource serialization system exists that this 
system can join or if any error flags were set during the snap- 
shot function of ISGBCI, GRS=JOIN is inconsistent with 

this environment. Set up message |SGOOGI with the 
appropriate informational message option that is 

specifically related to this condition, then go to Step 5; 
otherwise continue with step 4b. 

Invoke ISGBCI to send the CRB (command request 

block) to an active global resource serialization system 
identified in the snapshot list. The CRB describes a command 
that asks another system to bring this system into the complex. 
Flags in the CRB indicate that the system is joining the global 
resource Serialization complex. The system executing 

the command and bringing the joining system into the 
complex tells all other active global resource serializa- 

tion systems about the joining system and sends a copy 

of the global resource queues to the joining system. 

if ISGBCI cannot send the command, issue an ABEND 

with completion code X‘09A’ and a reason code 

identifying the specific nature of the error. 

Link to |ISGCQMRG to copy the global resources held ISGCQMRG 
by other systems in the complex. Use the copy to 

generate ENQ requests for those resources. 
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Diagram 49. Global Resource Serialization Option Processor (ISGNGRSP) Part 5 of 10 
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Diagram 49. Glohal Resource Serialization Option Processor (ISGNGRSP) Part 6 of 10 


Extended Description Module Label 


4 (continued) 


ISGNRTY‘1 is a retry point that receives control via ISGCRV ISGNGRSP ISGNRTY1 
through RTM. if an error occurs during the queue merge 

process (ISGCQMRG), and the queue update has completed, 

ISGNGRSP retries at this point. 


d. indicate in the GVT that global resource serialization ISGBCI ISGBCFNM 
option processing is complete (GVTGRSPC=1) for (SENDCMD) 
the joining system. 

e. Issue a console message to tell all active global resource 
serialization systems that a new system has joined the 
global resource serialization complex. Issue an ABEND 
with completion code X‘Q9A’ if broadcasting the 
message is unsuccessful. The reason code specifically 
identifies the error. 


5 ISGNRTY2 is a retry entry point that receives control 
via ISGCRCV through RTM. If an error occurred 

during global resource serialization option processing, 

ISGNGRSP will retry at this point to issue a message 

about the error that occurred. ISGNRTY2 also is the 

place in ISGNGRSP whera all messages that were set 

up in earlier steps are issued. 


a. To issue an informational and/or prompt message to ISGNGRSP ISGNRTY2 
the operator, set up the MRB (message request block) 
describing the message(s). Invoke the global! resource 


serialization message module (ISGMSGOO} to issue the ISGMSGO00 
message. 
b. If aprompt message asked the operator to respecify ISGNGRSP 


the GRS=option, set the correct option processing flag 
(GVTSTART=1, GVTJOIN=1, or GVFNONE=1) in 
the GVT, based on the response to the prompt. 


& _=siIf GRS option processing is complete (GRS-START 

or GRS=JOIN) was specified and the subsequent 
processing had no errors}, continue with step 8. !f 
GRS=NONE is specified, continue with step 7. Otherwise, 
return to step 2 to continue option processing. 
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Diagram 49. Global Resource Serialization Option Processor (ISGNGRSP) Part 7 of 10 
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Diagram 49. Global Resource Serialization Option Processor (ISGNGRSP) Part 8 of 10 


Extended Description 


7 a. Invoke the STARTPOP (NONE) function of 
ISGBCI to tell the ring processing/command 
interface to stop ring processing activities. Com- 
munication with other global resource serialization 
systems is then not possible. 
b. Deactivate global resource serialization by performing 
the following process steps: 


e QObtain the global resource serialization local lock 
using the SETLOCK macro instruction. 

e Set the GVTNONE flag onin the GVT. 

e POST the RB {(GVTGRPRB) for ISGGRPOO 
using IEAOPTO1 post routine. ISGGRPOO checks 
the GVTNONE flag. If it is set, all global requests 
on the process queue are treated as local requests. 
ISGGRPOO then exits. 

e Release the global resource serialization local lock 
using the SETLOCK macro instruction. 

c. Indicate in the GVT that global resource serialization 
option processing is complete (GVTGRSPC=1). 

d. Using ISGMSGO0O, inform the operator (with message 
ISGO10E) that no global resource requests can be 
processed because the global resource serialization 
option has been switched to NONE. 


Module Label 
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THagram 49. Global Resource Serialization Option Processor (ISGNGRSP) Part 9 of 10 


Input Process 


ISGNRTY 3: 


8 Delete the recovery 
environment, 


oo] wu wash VX/SAW QPe-S 









ISGNRTY4: 
ESTAE Q Return. 
parameter 
list ISGCRCV 

ISGNERRX: 


1Q Investigate the cause 
of the error. 


11 Decide whether to 
deactivate global 
resource serielization 
Or to retry. 
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Diagram 49. Global Resource Serialization Option Processor (ISGNGRSP) Part 10 of 10 


Extended Description Module Label 


8  ISGNRTYS is a retry entry point that receives control ISGNGRSP ISGNRTY3 
from ISGCRCV through RTM when an error has 

occurred after global resource serialization processing has 

completed. Cancel the ESTAE recovery environment for 

ISGNGRSP. Continue with step 9. 


Q  ISGNRTY4 isa retry entry point that receives ISGNGRSP ISGNRTY4 
control from ISGCRCV through RTM when an error 
occurred in trying to cancel the ESTAE for ISGNGRSP. 


Return to ISGNASIM with a return coda of zero. 


Recovery Processing 


ISGNERRX is the special error exit for ISGNGRSP. It 
receives control from ISGCRCV through RTM. ISGNERRX 
investigates the cause of the error and decides what action 
to take. Input to ISGNERRX consists of the general 
purpose registers whose contents are as follows: 


Registers 0 and 1 — undefined. 

Register 2 — address of ESTAE parameter list. 

Register 3 — address of the command recovery work 
area (CRWA). 

Register 4 — base register for ISGCRCV. 

Register 5 — address of the SDWA or zero if it is invalid. 

Register 6 — address of the GVT or Zero if it is invalid. 

Register 7 — address of the GVTX or zero if it is invalid. 

Register 8-13 — undefined. 

Register 14 — return address. 

Register 15 — address of ISGNERRX. 


1Q Using the processing information checkpointed ISGNGRSP ISGNERRX 
throughout ISGNGRSP processing in the command 

recovery work area (CRWA), determine the processing 

that was taking place at the time of the error. 


Extended Description Module Label 


11. Decide if retry back into ISGNGRSP is feasible or 

if global resource serialization should be deactivated. 
lf global resource serialization should ba deactivated, 
indicate no retry and perform the following steps: 


e Obtain the global resource serialization local lock ISGNGRSP GETLK1 
using the SETLOCK macro instruction. 

e Set the GVTNONE flag on in the GVT. 

e@ Call IEAOPTO1 to post the RB (GVTGRPRB) for IEAOPTO1 
ISGGRPOO. ISGGRPOO checks the GVTNONE 
flag. If it is set on, all global resources on the process 
queue are treated as local requests. ISGGRPOO then 
exits. 

e Release the global resource serialization local lock ISGNGRSP FREELK1 
using the SETLOCK macro instruction, 


For retry, set the correct retry entry point according to ISGNGRSP 
the Information in the CRWA ans set up an information 
that is needed at the retry point. 


Depending on the nature of the error causing ISGNERRX 
to get control, four retry points are possible from 
ISGNERRX into ISGNGRSP: 

e@ ISGNATY1 — step 4d. 

@ ISGNRTY2 — step 5. 

@ ISGNRTYS3 — step 8. 

e ISGNRTY4 — step 9. 
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JHagram 50. Global Resource Serialization Qucue Merge (ISGCQMRG) Part 1 of 6 


ISGNGRSP or 
ISGCRST 


Input Process 








ISGCQMRG: 


1 Obtain storage for global 
resource information and 
for data received from 
other systems. 


2 Ensure that the inclusion, 
exclusion, and reserve 
resource name lists (RNLs) 
for this system match the 
lists of the active global 
resource serialization 
system. 


GVTCMPAT 


3 Obtain resource informa- 
tion from the active global 
resource serialization 
system. 


RIB & RIBE 
information for 4 


Check that each resource 
this system 


exists in this system, 














Output 
Flag all 
global QCBs Buffer 
eel 
Compatibility level! 
indicator 
RNLs 


ISGBCI 


Buffer receive 
(BUFRECV) 
function Buffer 


RIBs 
RIBEs 


ISGBCI 


Buffer receive 
(BUFRECV) 
function 


RIB & RIBE 


information in 
GQSCAN format 





ISGQSCAN 


Search resource 
queues. 
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Diagram 50. Global Resource Serialization Queue Merge (ISGCQMRG) Part 2 of 6 


Extended Description Module Label 
ISGNGRSP {or ISGCRST) calls queue merge (ISGCQMRG) 

to verify that the inclusion, exclusion, and reserve lists in 

this global resource serialization system match those inclu- 

sion, exclusion, and reserve lists of the global resource sari- 

alization complex. ISGCQMRG also generates the ENQ or 

DEQ requests necessary so that this system's global re- 

source queues match those of the complex. ISGCQMAG 

loads module ISGGQOSRYV to use the various global resource 

serialization service routines provided by ISGGQSRV. 


ISGCQMAG uses the various global resource serialization 
service routines of ISGGOSRV. 


1 = After performing some initialization for subsequent ISGCQMRG 
processing and recovery, issue the GETMAIN macro 

instruction to obtain storage (64K bytes) from subpool 229. 

60K of this storage is used as a buffer to hold the data sent 

from an active global resource serialization system. The 

remaining 4K is used as a work area when scanning the 

resource queues of this system. Invoke ISGGQS01, which 

sets a flag in all QCBs. The flag indicates that the QCB has 

not yet been processed by ISGCQMAG. 


2 __=siInvoke the buffer receive function of ISGBCI. The 

first buffer sent by the global resource serialization 
system contains the global resource serialization com- 
patibility level indicator followed by the inclusion, exclu- 
sion, and conversian resource name lists (RNLs). To pre- 
serve Gata integrity, these lists must match the ones speci- 
fied for this system. 


ISGBCI BUFRECV 


If the compatibility level indicator does not match that of 
the complex or if the lists do not match, issue an ABEND 
with completion code X‘'09A’, and a reason code appropriate 
for the error condition. If the compatibility levels are the 
same and the lists match, continue with Step 3. 


3 ~=Invoke the buffer receive function of ISGBCI again to ISGBCI BUFRECV 
cause the active global resource serialization system to 

send the global resource queues to this system. ISGBCI 

does not return control until the data has been copied into 

the buffer area provided. Ensure that the resource informa- 

tion blocks (RIBs) and resource information block exten- 

sions (RIBEs) are constructed properly. If they are not, 

issue an ABEND with completion code of X'O09A’ and an 


appropriate reason code; otherwise, continue with Step 4. 


Extended Description Module Label 


4 Copy the qname and rname from the resource infor- ISGQSCAN QOSCAN 
mation block (RIB) for each resource and pass these names 

to ISGQSCAN using the GQSCAN macro instruction to 

obtain any information this system has describing 

requesters of the resource. (ISGQSCAN is the module that 

obtains this information.) If ISGOQSCAN returns a return 

code indicating that no data was found, issue an X‘09A’ 


ABEND with an appropriate reason code. 
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Diagram 50. Global Resource Serialization Quewe Merge (ISGCQMRG) Part 3 of 6 


input Process Output 







F Generate the ENO and DEQ 
requests necessary to make 
the list of requesters for each 
global resource match the 
list on the active global 
resource serialization 
system. 


a. Map GQSCAN informea- 


tion into a QWB suitable 
for the process queue. 


























Ri6 & RIBE 
information 
in GQSCAN 
format 
















{SGGQws0 














Obtain and 
initialize 
a QWB 


ENQ/DEQ requests 
on process queue 


QWB (ENQ a) 
QWB (ENQ b) 
QWs (ENQ c) 


Add QWB 
string to the 
Process Queue 






















b. Place the QWB on the 
process queue. 





6 Repeat Steps 3-5 for all 
global resources known 
by the active global 
resource serialization 
system, 








Way Jo Aysadoug — syeisajzey,, posuaory 


cA JO STR97e A! Pos, 


uoT]eJadg Jo poyyay “Ss UOTIaS 


Ise-s 


L861 ‘7861 “dod WaT W8hdoD © F-007I-87AT 


C 


Diagram 50. Global Resource Serialization Queue Merge (ISGCQMRG) Part 4 of 6 


Extended Description Module Label 


5 Generate and queue the ENQ/DEQ requests necessary 

to make the system’s list of requesters for global 
resources match the list on the active global resource seriali- 
zation system. 


a. Invoke [SGGQOWBSO to map the information in the ISGGQWBO ISGGOQWB2 
GOSCAN buffers into a QWB that is suitable for the 
process queue. 


b. Place this QWB on the process queue by invoking ISGBSR iISGBBE 
ISGBSR. 
6 Repeat Steps 3-5 until the active global resource ISGCOMRG 


serialization system has sent all the information 
about each global resource on that system. 
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Diagram 50. Global Resource Serialization Queue Merge (ISGCQMRG) Part 5 of 6 


Input Process 


Global QCBs 
J Generate DEQ requests for 


pC all the resources owned or 
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Global QELs Generate DEQ 
requests 


Return to 
caller 





Output 
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Diagram 50. Global Resource Serialization Queue Merge (ISGCQMRG) Part 6 of 6 


Extended Description Module Label 


7 .If this system had been quiesced and is now being 

restarted into the complex, this system can show some 
resources owned by other systems that have actually re- 
leased those resources. These resources were not in the list 
that was sent by the active global resource serialization 
system and must be removed from this system’s global 
resource queues. 


Invoke ISGGQSOQ3 to scan the QCB/QEL chains and gener- ISGGQSO03 
ate DEQ requests for all requesters of resources not known 

to the other systems in the complex. The resource requests ISGCQMRG 
of this system now match those of the active global 

resource serialization system. Free the storage used for 

GQOSCAN information and return to the caller with an 

indication in the GVT that the merge was successful 

(GVTQMRGA=0O). If |SGGQSO3 is unsuccessful, issue 

an ABEND with a completion code of X‘09A’ and a reason 

code identifying the specific nature of the error. 


Recovery Processing: 


When an error occurs while ISGCQMRG is executing, 
RTM calls ISGCRCV. ISGCRCV passes control to a 
special error exit routine in ISGCQMRG to perform the 
following: 


e Release any storage obtained for QWBs 
e Delete module ISGGQSRV 
e Specify storage to be released by ISGCRCV 


1{SGCQMRG returns contro! to ISGCRCV to process 
the following recovery options: 


e Retry if allowed 

e Take a dump using default options 

e Release dynamic area and buffer area obtained for 
GOSCAN and BUFRECV 

e If retry is not allowed, ISGCRCV returns control to 
RTM to continue with termination 
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Diagram 51. Global Resource Serialization Mainline Service Routine Initialization (ISGGSRVI) Part 1 of 2 


ISGNASIM 
Input Process Output 


1 Initialize the entry point 
addresses of all mainline 
service routines in the 
global resource serialization 
vector table extension 
(GVTX). 
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Diagram 51. Global Resource Serialization Mainline Service Routine Initialization (ISGGSRVI) Part 2 of 2 


Extended Description 


ISGGSRVI receives contro! from ISGNASIM in order to 
initéalize all mainline service routine entry points. 


1 


Set the following entry point addresses in the GVT X: 
GVTXDEOP — entry point address of ISGGDEOQP, the 


routine that purges focal resources. 


GVTFXQWB1 — entry point address of ISGGQWB1, the 
routine that builds a queue work block (QWB) from a 
ring system authority (RSA) message. 

GVTXQWB2 — entry point address of ISGGQWBZ2, the 
routine that builds a QWB from a resource information 
block (RIB) or a resource information block extent 
(RIBE}. 

GVTXQWB4 — entry point address of !SGGQWB4, the 
routine that builds a DEQ QWB from a queue element 
(QEL). 

GVTXQWBS5 — entry point address of ISGGOQWBS, the 
routine that builds aSYSID, ASID, or FCB DEQ QWB. 
GVTXQWBF — entry point address of ISGGQWBF, the 
routine that frees a QWB. 


Note: ISGGQWB1, ISGGQWB2, ISGGQWB4, ISGGQWB5 
and ISGGQWE6BF are all entry points of ISGGQWBO. 


Recovery Processing 


None. 


Module Label 


ISGGSRVI 
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Diagram 52. Dumping Services Address Space RIM (IEAVNPS7) Part 1 of 2 


IEAVNIPM (Step 32) 
Process Output 


IEAVTSAS 


7 Link to 1EAVTSAS. Dumping services 
address space 
creation 


Input 














Parameter list 


EATTR 


2 Initialize the attribute list 
and the parameter list. 


IEAVTSAI 
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4 Wait for the DUMPSRV 
address space to be length | ‘DUMPSRV, 
initialized. SUB=MSTR’ 


BK, If address space creation Error message 1EA768I 
fails, issue an error 


System address 
creation 


EAERIMWT 


message. 


Reason code 
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Diagram 52. Dumping Services Address Space RIM (IEAVNPS57) Part 2 of 2 
Extended Description Module Label 


IEAVNIPM calls the dumping services RIM, IEAVNP5/7. 
IEAVNP5?7 calls [EAVTSAS to create and initialize the 
dumping services address space (DUMPSRV) by using the 
system address space create routine (/EEMB881). 


For an overview of dumping services address space 
initialization, see Figure 4-5. 


1 IEAVNPS57 issues the LINK macro instruction to IEAVNP57 
give IEAVTSAS control. 

2  IEAVTSAS initializes the DUMPSRV address space 
attribute list so that the address space is: 

e Exempt from system non-dispatchability. 

@e Swappable. 

@e Cancellable and forceable. 

e Allowed to be terminated. 

Set the START parameters to contain only the name of the 

dumping services address space (DUMPSRV}) and set the 

address of dumping services address space initialization 

(IEAVTSAI) that will initialize DUMPSARYV. 

3  JEAVTSAS issues the LINK macro instruction to 
give |EEMB881 control, passing the parameter list 

that contains the address of IEAVTSAI and the name of 

the DUMPSRV procedure in SYS1.PROCLIB, IEEMB881 IEEMB881 


creates the DUMPSRV address space and invokes 
f[EAVTSAI to initialize it. IEEMB881 passes back a return 
code indicating whether or not the DUMPSRV address 
space was created. 


C 


Extended Description Module Label 


4 =s|f \EEMB881 is successful, wait on an ECB (EAECB) IEAVTSAS 
until it is posted by IEAVTSAI. After EAECB is 

posted, check the return code in the ECB (EAERIMWT) to 

see if initialization was successful. If it was, return to the 

caller. If initialization was not successful post the ECB 

(EAEASWT} to notify IEAVTSAI that it might 


terminate. IEAVTSAS then returns to IEAVNPS5/7. 


5 If IEEMB881 successfully created the DUMPSRV IEAVNP57 
address space, but JEAVTSAI was unsuccessful in initial - 
izing the address space, issue error message |EA7681 with a 


reason code of 2. 


lf IEEMB881 was unsuccessful in creating the DUMPSRV 
address space, issue the same message, JEA7681, but with 
a reason code of 1. (Use the IEAPMNIP service routine 
to issue the error message in either case.) 


Return to the cafler whether successful or unsuccessful. 


Recovery Processing 


None. 
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Diagram 53. Dumping Services Address Space Initialization (IEAVTSAI) Part 1 of 2 
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Input Process 
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EAERIMWT 
EAEASWT 













3 Set an authorization index 
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Diagram 53. Dumping Services Address Space Initialization (IEAVTSAI) Part 2 of 2 


Extended Description Moduis Label 


The started task control routine, IEEPRWI2, calls 
IEAVTSAI to initialize the dumping services address space 
(DUMPSR V) with a summary dump extended work area 
(SMEW) and a SDUMP virtual buffer. IEAVTSAI is an 
example of model system address space 

initialization 


1 Ca':ulate the size of storage needed for a SMEW and lEAVTSAI 
the SOUMP virtual buffer. Issue the GETMAIN macro 

instruction to acquire the storage from subpool 229. If the 

GETMAIN is unsuccessful, post the input ECB (EAERIMWT) 

with a failure return code to indicate to IEAVTSAS that 

DUMPSRV address space initialization is unsuccessful. 


Then wait for LEAVTSAS to POST the ECB (EAEASWT). 
This action ensures that the ECB (EAERIMWT) is not freed 
before L|EAVTSAS has a chance to examine it. Then set up a 
return code of 4 to notify the caller, |EEPRWI2, that it 
should perform cleanup processing for the DUMPSRV address 
space and return to the caller. 


if the GETMAIN is successful, continue with step 2. 


2 Format the SOUMP virtual storage buffer anda SMEW  IEAVTSAI 
from the acquired storage. Save the SMEW’s address in 

the RTCT and set the address of the SOUMP virtual storage 

buffer in the SMEW. Make the RTCT point to the 

DUMPSRV address space. 


3 Set the authorization index for the DUMPSRV address itEAVTSAI 
space to 1 so that SDUMP has full authorization to use 
cross memory instructions. 


4 _siInvoke the system's cross memory post function to tell IEAVTSAI 
IEAVTSAS (the dumping services address space creation 

routine) that the DUMPSRV address space is initialized. Issue 

a return code of zero and return to [EEPRWI2 to continue to 

initialize the DUMPSRV address space. 


For information on the DUMPSRV job steptask (IEAVTDSV), 
see System Logic Library. 


Recovery Processing 
None. 


C 


WAI J0 Apodoig — speiuayeya] posuzor'y 


sAd 5° SfPls9yBIAl P33}2143594j,, 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Diagram 54. Communications Task Initialization (IEAVNPA!) Part 1 of 8 


IEAVNPAl - MODULE DESCRIPTION 





DESCRIPTIVE NAME: Communications Task RIM. 
FUNCTION: 
Verifies "CON="" system parameter and passes control to the 
front end processing of the console member of Parmlib. 
ENTRY POINT: IEAVNPA2 
PURPOSE: Verifies "CON="" System Parameter 
LINKAGE: CALL statement 
CALLERS: IEAVNIPM 
INPUT: 
PARMTAB contains a pointer to the suffix value for the 
CONSOLxx member of SYS1.PARMLIB. 
OUTPUT: 
Message to prompt the operator to respecify the system 
parameter, if a new CONSOLxx member is needed. 
EXIT NORMAL: Return to the caller 
EXTERNAL REFERENCES: 
ROUTINES: 
IEAVN600 - Front end processor of the CONSOLxx member of 
SYS1.PARMLIB. 


CONTROL BLOCKS: 





Common Name Macro Name Usage 
CVT CVT R 
Nip Vector Table IHANVT R 
Nip Parm Address 

Table Entry IEAPPNIP R 
Nip Parm List IEAPMNIP C 
BASEA IEEBASEA M 
SNPL IEEZB807 Cc 
UCM IEECUCM M 


KEY = C - Create, D - Delete, M - Modify, R - Read 


TABLES: TRTABL 


5-360 MVS/XA System Init Logic LY28-1200-4 © Copyright IBM Corp. 1982, 1987 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Diagram 54. Communications Task Initialization (IEAVNPA1) Part 2 of 8 


ITEAVNPA1L - MODULE OPERATION 


Initialize the variables and get addressability to NVT; 
NIPPAREA and PARMTAB. 


Get storage for Scheduler NIP Parameter List. 


Check that a value was specified for the "CON" parameter 
and that it is two characters and alphanumeric. Also, 
determine if the user specified the list option. 


If the "CON" specification is not valid, prompt the 
operator, using the NIP service, to respecify the value 
correctly. 


Call IEAVN600, the front end processor of the console 
member in Parmlib, passing the suffix for the Parmlib 
member name and a flag to indicate that the user 

wanted the list option. Interrogate the return code and 
issue a message if needed. 


Store the address of NIP hardcopy message buffer (NVTMBUP ) 
into UCMNIPTR in UCM Event Indication List. 
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Diagram 54. Communications Task Initialization (IEAVNPAI) Part 3 of 8 


IEAVNPA1 - DIAGNOSTIC AIDS 





ENTRY POINT NAME: IEAVNPA1 


MESSAGES: 
Issued via IEAPMNIP 
IEA187I - FORMAT OF THE CON SYSTEM PARAMETER IS NOT VALID. 
IEA193I ~ CONSOLXX NOT USABLE. text 
text - UNABLE TO SELECT MASTER. REASON=Erc 
re=1 - No full capability console is defined 
in the CONSOLxx PARMLIB member. 
re=2 - No valid full capability console is defined 
in the CONSOLxx PARMLIB member. 
rc=3 - No online full capability console is defined 
in the CONSOLxx PARMLIB member. 
text - NO VALID CONSOLE STATEMENTS FOUND. 
text - I/0 ERROR OCCURRED. 


ITEA332A ~- SPECIFY CON 


ABEND CODES: None 


WAIT STATE CODES: None 





RETURN CODES: 
EXIT NORMAL: 


Register 15 contains 0 


REGISTER CONTENTS ON ENTRY: 


Reg Oarndi1-— ~- Irrelevant 

RNVT (Reg 2) =< Address of NIP Vector Table (NVT) 
Reg 3 - 12 - Irrelevant 

Reg 13 - Address of Save Area 


REXIT (Regl4¢) -<- Return Address 
RENTRY (Regl5) - Entry Point Address 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 


Registers 0-14 restored to contents upon entry 
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Diagram 54. Communications Task Initialization (IEAVNPA1) Part 4 of 8 


IEAVNPA1 - Communications Task RIM. STEP Ol 
TEAVNIPM 
Verifies "CON="" system parameter and passes control 
\ | |to the front end processing of the console member of 
>| |Parmlib. 
/ 
IEAVNPAL 





GENERATED MESSAGE DATA 


MAINLINE 


FUNCTION: 


Verify that the user specified the CON parameter. If 
mot issue a NIP PROMPT to request the operator to 
specify the CON parameter. 


Verify that the value specified for CON parameter is 
valid. If not issue the NIP WTO informing the 
operator and also issue the NIP PROMPT to request the 
operator to specify the CON parameter. 


Link 'IEAVN600' the PARMLIB member processor passing 
the suffix for the CONSOLxx member and a bit 
indicating whether the user requested the list 
option. On return, interrogate the return code and 
issue a NIP WTO explaining the error, if any and also 
issue NIP PROMPT to request the operator to specify 
the CON parameter. 


Store the address of NIP hardcopy message buffer into 
UCMNIPTR in UCM event indication list. 


When the user asked for the list option, NIP sets \ 
a flag in NIP Parameter Address Table Entry. NIP 7 | SWITCHES 


stores the parameter in the form of XX' or (XX)! 

depending on how the user specified it. NIP does 

some validation. However it is up to this module 

to verify that the data is alphanumeric and it is 
only 2 characters long. 


Title: Getmain storage for Scheduler NIP 


Parameter List from subpool 241 (CSA) and clear 
the storage 


(RU) LV (RU) LV(LENGTH(SNPL)) A(MSSCHED) SP{SPOOL) A(MSSCHED) SP(SPOOL ) 
BND eee a DBLWD ) 


IEEZB807 St ateheteteetttetate >| A. Getmain storage for SNPL \ 
/|GPROOF GPRO1F 
SNPL Perma GETMAIN | GPRI5F 


B. RC/RU FORM OF GETMAIN ‘Ciotwmses | 


< > SVC 120 


<= 


\IEEBASEA 


[seve 
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IEEZB807 





\ Getmain storage for SNPL | seezaeo7 
/ 7 
SNPPTRS 


Title: Loop through this module until the user 


\ specifies a valid Console member suffix and there 
/ is No major error while processing the member. 
IHANVT 
RNVT 
IEAPPNIP prccceccco- > Logic: If the operator did not specify the 


-: suffix, indicate that a prompt messaga needs to 
NIPPTADR be displayed. 


IEAPPNIP protcccccoe > Logic: Determine if there is a delimiter error 


=3 surrounding the suffix. If there 1s an error, an 
NIPPTADR error message followed by a prompt message needs | 


to be displayed 
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IEAVNPA1] - Communications Task RIM. 





Verify that the suffix is alphanumeric. If not an 


error message followed by the prompt message will 
be displayed. 


pecccseccc- > Translate the lower case alphabetic character to 
: upper case, if there are any 






IEAPPNIP 


NIPPTLST 


A. Link IEAVN600 
ss 


\e—47 LINK600: 15 


2 





Logic: If the syntax of the suffix was found to \IKANVT 
be in error, issue the message IEA187I 


Peer 
su 


nee IEAPMNIP | 
[TYPE=KTO; PARAM=SYNTXMSG | 


Logic: If any error was encountered, prompt the ew 


operator with the message IEA232A 


7 

| RNVT 

A. Issue the prompt message IEA332A 
sty 


\ ay) ITEAPMNIP | 
[TYPE=PRMPT PARAM=CONPARM | 


N 
/ 


PTRNVT 


ITEECUCM J sahaleteateateeteteaten > [23| Store the address of Nip Hardcopy message buffer \IEECUCM 
(NVTMBUP ) into UCMNIPTR in UCM Event Indication 
UCMLSTP 


7 
/ List. UCMNIPTR 
End of mainline 






THANVT 


LY28-1200-4 © Copyright IBM Corp. 1982, 1987 Section 5. Method of Operation 5-365 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Diagram 54. Communications Task Initialization (IEAVNPAI) Part 7 of 8 









\ 
15 > jas) TITLE: LINK600 
/ 
LINK600/|LOGIC: Link IEAVN600, the CONSOLxx processor. On 
return check the return code and issue appropriate 
messages. 





A. Logic: Link to IEAVN600, the CONSOLXX member 
processor. The parameters passed are the 2 
character suffix and a byte to indicate whether 
the operator requested the list option or not. 


LINK 


|EP(VN600) PARAM( SUFFIX,PASSBYTE } | 


B. ISSUE LINK SVC | 


< > svc 6 





C. Logic: If an error code is returned from the | be 
CONSOLXX processor, Issue the error message 
IEA193I followed by tha prompt message IEA332A. 
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Cc IEAVNPA1 - Communications Task RIM. STEP 15D 
\| D. Issue the message IEA193I - UNABLE TO SELECT 
PTRNVT / MASTER, with an appropriate reason code. 


soy 


\-—| IEAPMNIP ] 
[TYPE=HTO, PARAM=NOMSTR | 


E. Return code is ¢ - No valid statement was found 


mw F. Issue the message ITJEA193I - NO VALID STMT FOUND 
PTRNVT / 
G. Issue the msg IEA193I1 
7, 
\-—/| IEAPMNIP ] 
[TYPE=HTO, PARAM=NOSTMT | 


H. Return code is 5 - I/O error 


\| I. Issue the message IEA193I - I/O ERROR CCCURRED. 
PTRNVT / 
J. Issue the msg IEA193I 
7 
\-—/| IEAPMNIP ] 
[TYPE=HTO, PARAM=IOERROR | 


K. Return code must be 6 | 


L. Returns to the subroutine caller. | 
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IEAVN600 - MODULE DESCRIPTION 





DESCRIPTIVE NAME: CONSOLxXxX Member Front End Precessor 


FUNCTION: 

Reads the records from the CONSOLxx member of 
SYS1.PARMLIB, calls IEEMB887 to syntax check the user 
specified input for the CONSOLE, HARDCOPY, DEFAULT 
and INIT statements, which will in turn call IEAVN601,; 
IEAVN602, and IEAVN604 to build the Console Data Area. 
Also calls IEAVN613 to select the master console 

and to initialize the UCM control blocks. 


ENTRY POINT: IEAVN600 
PURPOSE: Process CONSOLxx member of SYS1.PARMLIB 
LINKAGE: LINK 
CALLERS: IEAVNPAI1 
INPUT: 

Register 1 points to two 4 byte fields. 

The first word contains the address of the suffix 

value of CONSOLxx member of SYS1.PARMLIB. 

The second word contains the address of a byte which 

indicates whether the user wanted the list option. 
OUTPUT: Return code passed back in register 15. 
EXIT NORMAL: Return to the caller 
EXIT ERROR: Return to the caller 


EXTERNAL REFERENCES: 








ROUTINES: 

IEEMB887 - Parses the CONSOLE, HARDCOPY, DEFAULT, 
and ENIT statements 

IEEMB878 - Reads the records from CONSOLxx member 

IEAVN610 - When parsing 1s finished for a statement 
(CONSOLE, HARDCOPY, DEFAULT; or INIT), 
IEAVN6é10 is called to validate the data 
specified on the statement. 

IEAVN613 - To select the master console and initialize 
the UCM control blocks. 

IEAVM200 -~- To Queue messages in the message queue 
which is anchored off the Console 
Data Area. 

PTCONSOL - Start of parse definitions in module 
ITEAVN603. 

CONTROL BLOCKS: 

Common Name Macro Name Usage 

MSGS IEAVM101 C.M,D 

CDEF IEAVN100 C,M>,D 

SCL IEEZB815 C,»M>D 

IEEMB878 Parmlist IEEZE8&22 C,M,D 


KEY = C - Create, D - Delete, M - Modify, R - Read 
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TEAVN600 - MODULE OPERATION 


Load the Parser module (IEEMB887) into virtual storage. 
Load the Parmlib read module (IEEMB878) into virtual 
storage. 

Load the Message service routine (IEAYVM200) into virtual 
storage. 


Initialize the Parameter List for the Parmlib read routine 
and the Parser Parameter List. 

Call IEEMB878 to read the first record from the CONSOLxx 
member of SYS1.PARMLIB - the prefix "xx" was passed 

to this module from the caller (IEAVNPAL1). 

If the return code indicates that the specified member 
does not exist or there was an I/O error, set the return 
code in reg 15 indicating this condition and return to 
the caller. 

If the user had specified the "L" option, list that 
record. 


Call the parser passing the Scan Parameter List. 

On return from the parser >» 

if the return code indicates that there was an I/O error, 
set the return code in reg 15 and return to the caller. 
If the return code indicates that there was an error 
processing the comment text in the CONSOLxx member; 

issue a warning message to inform the user. 

If the return code is anything but zero and none of the 
above mentioned, issue “SYSTEM ERROR" message with 

return and reason code that were obtained from the parser. 
Return to the caller with a return code in register 15. 


If the return code indicates that all the records have 
been parsed successfully, 

call IEAYN610, the Console validation module to process 
the last statement that was parsed (IEAVN610 is called 
to process all the other statements from CONSOLxx member 
exit modules, IEAVN601 and IEAVN602). 

Delete the modules IEEMB887 and IEEMB878 from virtual 
storage. 


After all CONSOLXX records have been parsed, 

call IEAVN613 to select the master console and to 
initialize the UCM control blocks. 

Delete the message service routine from virtual storage. 
Return to the invoker with return code. 


IOEXIT - 

This routine gets control whenever the module IEEMB887 
wants to get a new record from the CONSOLxx member in 
SYS1.PARMLIB. 

Set up the parameter list and call IEEMB878 to read a 
record from the CONSOLxx member in SYS1.PARMLIB. 

On return, if the record is successfully read, update 
the record number, store the address of the newly read 
record in Scan Control Block and return back to IEEMB887. 
If there was an I/O error, set the return code so that 
IEEMB887 (parser) stops. 

If there are no more records to read, set the return 
code so that IEEMB887 (parser) recognizes this condition. 
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IEAVN600 = DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAVN600 


MESSAGES: 
TEA195I ~ CONSOLxx LINE yyyyy: SYSTEM ERROR xxxx-yyyy. 
xx - Suffix for CONSOLxx member 
yyyyy - Record number in CONSOLxx member 


IEA196I - CONSOLxx stmt-type: UNBALANCED COMMENT 
FOUND. DATA IGNORED. 


- CONSOLx stmt~type: PREMATURE END OF FILE 


DETECTED. 
stmt-type - Device number(s), "SUBSYS", "DEFAULT", 
or "INIT" 


ABEND CODES: None 


WAIT STATE CODES: None 


RETURN CODES: 
EXIT NORMAL: 
Register 15 contains 0 
EXIT ERROR: 
Register 15 contains a non-zero value as described below. 


1 - Unable to select master. No full capability Console 
defined. 
2 - Unable to select master. No valid full capability 
Console found. 
Unable to select master. No online full capability 
Console found. 
No valid statements in CONSOLxx. 
I/O error while processing CONSOLxx. 
- CONSOLxx is not in SYS1.PARMLIB or 
SYSTEM ERROR occurred. 


Lal 
i 


alu S 
1 


REGISTER CONTENTS ON ENTRY: 


Register 0 - Irrelevant 
Register 1 - Address of a double word. 
- The first word contains the 
address of the suffix value 
of the CONSOL»x< member. 
- The second word contains the 
address of a byte which indicates 
whethor the user wanted the list 


option. 
Register 2-12 - Irrelevant 
Register 13 - Address of 72 byte save area 
Register 14 - Return address 
Register 15 - Entry address of IEAVN600 


REGISTER CONTENTS ON EXIT: 


EXIT NORMAL: 
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IEAVN600 ~ DIAGNOSTIC AIDS (Continued) 


Registers 0-14 restored to contents upon entry 
EXIT ERROR: 


Registers 0-14 restored to contents upon entry 
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IEAVN600 - CONSOLxx Member Front End Processor STEP 0O1 





IEAVNPA]1 
Reads the records from tne CONSOLxx member 
\ of SYS1.PARMLIB, calls IEEMB887 to syntax 
2|{check the user specified input for the 
/ CONSOLE, HARDCOPY, DEFAULT and INIT 
IEAVN600| | statements, which will in turn call 
N\| | IEAVN601, IEAVN602, and IEAVN604 to build 
/|| the Console Data Ares. Also calls TEAVN613 
to select the master console and to 
initialize the UCM control blocks. 


MAINLINE 


Read the first record from the CONSOLx~x 
member of SYS1. PARMLIB by calling 
IEEM8878. Call IEEM8S87 to parce the record 
according to the parse definitions in 
module IEAVN603. Call IEAVN610, the Console 
validation module to validate the last 
statement that was parsed but did not get 
validated (other statements were validated 
by IEAVN610 tnru calls from the parser 
exits modules, IEAVN601 and IEAVN602). 
Freemain the area that was getmained. 
Return to the invoker with return code. 


PARAMETERS 







SUFFIX FLAGS 
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IEAVN600 - CONSOLxXx Member Front End Processor STEP 02 
INITCB 02 | INITCB \IEEZB822 
IEAVN1O0 peencecn--- > / 
: \| |Load IEEMB878, IEEMB887 and IEAVM200 into PLIBAREA 

CONSDEFN CONMSGQP/ : /\|virtual storage and initialize the control 
CONMGQLP CONSPEC | : blocks. 
CONSEXTN 
IEAVM101 : \IEAVN100 
fess 
IEEZB822 
PLIBAREA 
PARAMETERS 
SUFFIX 

\SCL 
IEAVN100 7 
CONSOLID CONSVERS 

SCLVERSN 
SCL SCLDSC 
SCLIORTN 

SCLPARM SCLNAME SCLIOPAD 
SCLVERID 
TEAVM101 
MSGSIPTR MSGSNAME 
MSGSVERN 

\IEAVM1O1 

/ 
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TEAVN600 - CONSOLxx Member Front End Processor STEP 03 










CONPROC \IEAVM1O1 
SCL prccccceo- > / 
=: \| | Read a record from the CONSOLxx member of MSGSRFLG 
| [| |fiet taneas! Sor see eae reser, 
: to parse the member according to the 


IEAVN1OO syntax defined in the module IEAVN6D3. 





CONNUMEN CONMSGQP 
CONCONSB CONHCPYB 


CONDFLTB CONINITB 


IEAVN100 











GETRECRD 04 GETRECRD \SCL 
IEEZB822 Z| ---------- > / 
\| |] Call IEEMB878 (PARMLIB read routine) to SCLCHAR 
/\|get a record from the CONSOLxx member of SCLRET 
SYS1.PARMLIB. List out the record if the 
SCL user requested so. \IEAVN100 
/ 
SCLCHAR SCLNDSCN CONCURLN 
CONCARDP 
IEAVN100 CONDYFND 
CONCURLN \IEAVM101 
/ 
ITEAVMN1O1 MSGSLNUM 


MSGSMSGI 
MSPREBLT MSGSNMBI 


MSGSILNT 
MSGSITXT 





roexrr| |05| IOEXIT 
SCL posse > 


Get the next record from CONSOLxx member 
SCLIOPAD of SYS1.PARMLIB. 
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TEAVN600 - CONSOLxXx Member Front tnd Processor STEP 06 


errorcHk||06| ERRORCHK 
SCL J oo lenin eieatenieneatiend > 
\| | Interrogate the return code from the 
/{ {parser (IEEMB887), issue messages 
accordingly and set return code for the 
caller. 










SCLCURNT SCLRET 
SCLGOOD SCLBAD 
SCLUNDEF SCLOK 

SCLNOIO SCLBCOM 
DSCKEY 


SCL 








SCLRSN 





DSCKEYLN 








ISSUEMSG \IEAVM101 
TEAVM101  Sotasteatateteteteate > / 
~: \| |Build parameter list according to the 
: /||error and invoke the generalized message 
: service. 
TEAVN100 : 


CONCONSB CONHCPYB 
CONDFLTB CONINITB 


CONDEVNI CONDEVN2 
CONADEV2 CONDISPK 





PARAMETERS 

SCL : 
_J 

IEAVM101 


MS195I06 MS1961I14¢ 
MS196I15 


IEAVN100 


CONCURLN 
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IEAVN600 = CONSOLxx Member Front End Processor STEP 08 
FREEQUE 08. FREEQUE \IEAVN100 
/ 








ITEAVN100 \ 
/||Free the MSGRT commands and/or MONITOR 
CONMRQ CONMNQ commands from the queue depending on the 
return code from the validation routine 


(IEAVN610). 
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IBAVN601 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: CONSOLxx Member Exits - Part 1. 


FUNCTION: 

This module gets control from the parser (IEEMB887) 

to set up the Console Data Area for the CONSOLE statement 
key words whose value can be a list, and for ROUTCODE 

key word on HARDCOPY and DEFAULT statements. 

This module also gets control to process the errors found 
while parsing all the statement types. 


ENTRY POINT: TEAVN601 


PURPOSE ;: 
To store the user specified data in Console 
Data Area for further processing. 


LINKAGE: PL/AS CALL statement 


CALLERS: 
Parser Module - IEEMB887, via the parse 
definitions in IEAVN603 


INPUT: 
Register 1 points to a word which contains address of the 
Scan Parameter List. 


OUTPUT: 
Updated Console Data Area and/or 
Updated Scan Parameter List 
EXIT NORMAL: Returns to the caller. 
EXTERNAL REFERENCES: 
ROUTINES: 
IEAVN610 - To validate the data that the user specified 
via CONSOLE statement. 
IEAVM200 - To queue the error messages. 


CONTROL BLOCKS: 


Common Name Macro Name Usage 
CDEF ITEAVN100 R»M 
SCL IEEZB815 R»M 
MSGS ITEAVM101 C,M,D 
MGCR IEZMGCR Cc 
Index Table IEAVN102 C,D 


KEY = C - Create, D - Delete, M - Modify, R - Read 
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IEAVN601 - MODULE OPERATION 


When the parser finds a syntactically valid value for the 
keyword, it calls one of the exit routines to store the 
value in the Console Data Area. There are also 
routines to process several error situations. The operation 
of every major routine is explained below: 


CONSOLXT - 
This routine gets control whenever a CONSOLE statement 
is found in the CONSOLxx member. 


Verify this is the first non-comment data on the current 
record. 
If it is not queue the message “MISPLACED CONSOLE 
STATEMENT IGNORED" and ignore the data until the next 
statement type is found. 


Verify the number of Console Statements specified. 
If it is 99, the limit is reached. 
Queue the message “LIMIT OF 99 CONSOLES EXCEEDED". 
Ignore this statement and start looking for another 
statement type. 
If it is less than 99; add 1 to the CONSOLE statement 
counter. 


If a CONSOLE, HARDCOPY, DEFAULT, or INIT statement was 
Parsed just before, call the Console validation routine, 
IEAVN610, to validate the data that the user 
specified in that statement. 

Update the entry number in the Console Data Area. 

Set a flag to indicate that a CONSOLE statement is being 
processed. 


KEYEXIT - 
This routine gets control whenever a Key word or a 
key word value is found. 


Check the Key flags in the Console Data Area 
to verify that this Key word is not duplicately 
speci fied. 
If duplicate, queue "DUPLICATE KEY WORD" message and 
ignore the data until the next right parenthesis. 
Store the information that this key word is being 
processed. 
Also set the code to indicate that this Key word 
has been encountered. 


DEVNUMXT - 
This routine gets control when a value is found for 
DEVNUM Keyword in CONSOLE statement. 


If the value specified is "SUBSYSTEM", set the Console 
Data Area accordingly. 

If there are two DEVNUM values specified, increment the 
CONSOLE statement counter by 1. If the counter exceeds 
99, Set the error coda to issue the message "LIMIT OF 
99 CONSOLES EXCEEDED". 

Ignore this statement and start looking for a statement 
type. 

If the value is in hex, convert it to binary 

and verify that the value was not specified as DEVNUM 
value for a previous CONSOLE statement. 

If the DEVNUM was specified in a previous CONSOLE 
statement, Issue the message "DEVNUM ALREADY DEFINED. 
STATEMENT IGNORED.". If the second device number is the 
same as the first device number when it is a composite 
console, issue the message ''CONSOLE STATEMENT IGNORED. 
REASON=3". 

Ignore this statement and start looking for a statement 
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IEAVNGO1 - MODULE OPERATION (Continued) 


type. 


AUTHXT - 
This routine gets control when a value is found for 
the AUTH key word. 


If the same value is repeated, issue the message 

“AUTH VALUE IGNORED" and ignore the duplicate 
specification. 

Set appropriate value in the Console Data Area. 

ff the value specified is mutually exclusive with one or 
more previously specified values, 

issue “INCONSISTENT AUTH VALUE IGNORED". 


ALTXT - 
This routine gets control when a value is found for 
the ALTERNATE key word. 


Convert the value to binary. 

If it is the input part of a composite console, set 
the value in the Data Area. 

If it is the output part of a composite console, 
verify that it is not the same as input part of the 
composite console. If it is issue “ALTERNATE VALUE 
IGNORED. REASON=2". 


ROUTXT - 
This routine gets control when a value is found for 
the ROUTCODE key word on CONSOLE, HARDCOPY, or DEFAULT 
statements. 


If the value specified is mutually exclusive with one or 
more previously specified values, set the error code to 
issue "INCONSISTENT ROUTCODE VALUE IGNORED". 

If the specified value is decimal, convert it to binary. 
If the value specified is greater than 128, or if the 
range was specified, and it is in descending order, 

set the error code to issue the message "ROUTCODE VALUE 
IGNORED. REASON=1". 

If the same value is repeated, set the error code to 
issue the message "DUPLICATE ROUTCODE VALUE IGNORED" and 
ignore the duplicate specification. 

For any valid ROUTCODE value, set appropriate 

bits in the Console Data Area. 


LEVELXT - 
This routine gets control when a value is found for 
the LEVEL Key word. 


If the value specified is mutually exclusive with one or 
more previously specified values, set the error code to 
issue "INCONSISTENT LEVEL VALUE IGNORED". 

If the same value is repeated, set the error code to 
issue the message "DUPLICATE LEVEL VALUE IGNORED" and 
ignore the duplicate specification. 

Set appropriate value in the Console Data Area. 


MFORMXT - 
This routine gets control when a value is found for 
the MFORM Key word. 


If the value specified is mutually exclusive with one or 
more previously specified values, set the error code to 
issue the message "INCONSISTENT MFORM VALUE IGNORED". 

If the same value is repeated, set the error code to 
issue the message “DUPLICATE MFCRM VALUE IGNORED" 

and ignore the latter specification. 

Set the appropriate value in the Console Data Area. 
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Diagram 55. IEAVN600/[IEAVN601 Part 13 of 53 
IEAVN601 - MODULE OPERATION (Continued) 


AREAXT - 
This routine gets control when a value is found for 
the AREA key word. 


If the value specified is mutually exclusive with one or 
more previously specified values, seat a bit to 

issue the mossago "AREA VALUE IGNORED. REASON = 1". 

If specified value is anything but "none", 

Convert the value to binary. 

Store the value in the Console Data Area. 

If more than 11 values are specified, set a bit to 
issue the message "AREA VALUE IGNORED. REASON = 1". 


MRMNXT - 
This routine gets control when a value is found for 
the MSGRT or MONITOR key word. 


Getmain the storage for MSGRT or MONITOR commands 


If the key word 1s MSGRT 

Tag an "MR ” in front of each command and queue it in 
the console command queue. 

Store the address of the Console command queue in the 
Console Data Area 


If the key word 1s MONITOR 

If the same value is repeated, set error code to issue 
"DUPLICATE MONITOR VALUE IGNORED”. 

Build an MN command and queue it in the MONITOR command 
queue, off the Console Data Area. 


FREEQUE - 
This routine gets control when an error return code is 
received from IEAVN610, the CONSOLxx validation module. 


Interrogate the return code and free MSGRT command queue 
and/or MONITOR command queue accordingly. 


FINDPOS - 
This routine gets control from the ROUTXT subroutine to 
find the position of the byte and the bit for a numeric 
ROUTCODE value. 


BADDATA - 
This routine gets control whenever an unrecognizable 
key word or statement type is found. 


If this is the first non-comment data in this 

record, determine whether it is a possible 

statement type. If it is, issue a message "UNRECOGNIZED 
STATEMENT TYPE" and skip data until a valid 

statement type. If it is an erroneous Key word, 

issue a message "UNRECOGNIZABLE KEY WORD" and 

skip data until the naxt rignt parenthesis. 


If this is not the first non-comment data in this 
record, issue the message "UNRECOGNIZABLE KEY 
WORD" and skip data until the next right 
parenthesis. 


CKSTTYPE - 
This routine gets control when the parser has 
detected a bad value. 


Check the data to see if it is a now statement type, 
if it 1s a message is displayed for a "MISSING RIGHT 
PARENTHESIS ASSUMED" and the parser 1s instructed to 
take the second successor route. 
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IEAVN601 - MODULE OPERATION (Continued) 


ZEROOUT - 
This routine gets control when the parser has 
detected an extra value for a key word that is only 
allowed one value. 


A "single value key word" does not have a valid 
delimiter ('}'). Reset the fields that were 
previously set. 


CKVALUE - 
This routine gets control when the parser has 
detected a bad value. 


Check the data to see if it is the first value 


specified for the key word, if it is, the message 
“aaaaaaaa VALUE IGNORED. REASON=rc" is displayed. 
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ENTRY POINT NAME: IEAVN601 


MESSAGES: 
IEA195I CONSOLxx LINE yyyyy: text 
xx: Suffix for the member name. 
yyyyy: Line number in CONSOLxx member. 


text: 
UNRECOGNIZED STATEMENT TYPE IGNORED. 


CONSOLE STATEMENT IGNORED. REASON=rc 

1 - The DEVNUM key word is not the first Key word 
following the CONSOLE statement type. 

2 - The DEVNUM Key word value was not hexadecimal 
or in the range of 000 to FFF. 

3 - A CONSOLE statement had the same device 
number specified for the input and output 
half of a composite console. 


99 CONSOLES DEFINED. STATEMENT IGNORED. 
MISPLACED xxxxxxxx STATEMENT IGNORED. 
IEA196I CONSOLxx stmt-type: text 


xx: Suffix for the member name. 





stmt-type: Device Number(s), "SUBSYS", “HARDCOPY”, “DEFAULT”, 
or “INIT. 


text: 
UNRECOGNIZED KEYWORD aaaaaaaaaaaa IGNORED. 


@aaaaaaaa VALUE IGNORED. REASONS=rc. 

1 - The value does not conform to the syntax of 
the Key word or the value is out of range 
for the key word or for the Console's 
device type. 


2 - The input and the output part of the 
composite console were the same for the 
ALTERNATE Key word on a CONSOLE statement 
or the DEVNUM Key word on the HARDCOPY 
statement. 

INCONSISTENT aaaaaaaa VALUE IGNORED. 
MISSING RIGHT PARENTHESIS ASSUMED. 

DEVNUM ALREADY DEFINED. STATEMENT IGNORED. 
DUPLICATE aaaaaaaaa KEYWORD IGNORED. 


DUPLICATE aaaaaaaaa VALUE IGNORED. 


ABEND CODES: None 





WAIT STATE CODES: None 
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RETURN CODES: 


EXIT NORMAL: 


Register 15 contains 0 


REGISTER CONTENTS ON ENTRY: 


Register 
Register 


Register 
Register 
Register 
Register 


0 
1 


2-12 
13 
14 
15 


- Irrelevant 


Address of a word which 

contains the address of the Scan 
Parameter List 

Irrelevant 

Address of 72 byte save area 
Return address 

Entry address of IEAVN601 


REGISTER CONTENTS ON EXIT: 


EXIT NORMAL: 


Registers 0-14¢ restored to contents upon entry 
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IEAVN602 = MODULE DESCRIPTION 


DESCRIPTIVE NAME: CONSOLxx Member Exits - PART 2. 


FUNCTION: 
This module gets control from IEEMB887, the parser 
to set up the Console Data Area with values that were 
specified for the HARDCOPY, DEFAULT, and INIT statement 
key words. 


ENTRY POINT: IEAVN602 


PURPOSE : 
To store the user‘s data in the parameter list 
for further processing. 


LINKAGE: PL/AS CALL statement 


CALLERS: 
Parser Module - IEEMB887, via the parse 
definitions in IEAVN603 


INPUT : 
Register 1 points to a word which contains address of the 


Scan Parameter List. 
OUTPUT: 

Updated Console Data Area and/or 

Updated Scan Parameter List 
EXIT NORMAL: Return to the caller with return code D 
EXTERNAL REFERENCES: 


ROUTINES: 
IEAVN610 - To validate the data supplied by the user in 


CONSOLE, HARDCOPY, DEFAULT; and INIT statement. 


IEAVM200 - To queue the informational or error messages. 


CONTROL BLOCKS: 





Common Name Macro Name Usage 
MSGS IEAVM101 C»M,D 
CDEF IEAVN100 R»M 
Index Table TEAVN102 c,D 
SCL IEEZB815 R»M 
MGCR IEZMGCR C,R 


KEY = C - Create, D - Delete, M - Modify, R - Read 
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IEAVN602 - MODULE OPERATION 


This module processes HARDCOPY, DEFAULT, and INIT statement 
types and all the key word values associated with them. 


NOTE: Processing of the ROUTCODE key word on HARDCOPY 
and DEFAULT statements is done in CONSOLxx Member 
Exits - Part l. 


STMTXT - 
This routine is invoked when the parser finds a 
HARDCOPY, DEFAULT, or INIT statement type. 


Verify that the statement type is not duplicately 
specified. 

If there was any statement that was parsed just 
prior to this, invoke the validation routine, 
IEAVN610 to validate the statement that was just 
parsed. 


KEYVALXT - 
This routine is invoked when the parser finds 
a value for a key word. 


Determine the reason for the entry and route control 
to a routine to the appropriate routine to process the 
value. 


DNCMDXT - 
This routine is entered to process the values for the 
HARDCOPY statement key words, DEVNUM or CMDLEVEL. 


DEVNUM value processing: 

If the value specified is "SYSLOG", set the Console 
Data Area accordingly. 

If the value is in hex, convert it to binary. 

If the user specified a composite console, verify that 
the input and the output part of the console is not the 
same. Set the error code to issue the message "DEVNUM 
VALUE IGNORED. REASON=2" 

Store the value in the data area, if no error found. 


CMDLEVEL value processing: 
Set the corresponding flag in the Console Data Area 
according to the value specified. 


This routine is invoked when the parser finds 
a value for CMDLEVEL key word in HARDCOPY statement. 


MLRLUXT- 
This routine is entered to process the value specified 
for MLIM or RLIM key word on INIT statement. 


Convert the value to binary. 
Set the value in the Console Data Area 


AMUXXT - 
This routine is entered to process the value specified 
for AMRF, or UEXIT key word on INIT statement. 


Store the value in Console Data Area depending on 
the user specified value. 


MPFPFKXT - 
This routine is entered to process the value 
specified for MPF, or PFK key word on INIT statement. 


Store the value in Console Data Area depending on 
the user specified value. 
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INMNXT - 
This routine is entered to process the value 
for MONITOR key word on INIT statement. 


If the same value is repeated, queue appropriate message. 
Build an MN command and queue it in the system command 
queue, 

Store the address of the first MN command in the 

Console Data Area 
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IEAVN602 =- DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAVN602 


MESSAGES: 
IEA195I CONSOLxx LINE yyyyy: text 
x: Member name suffix 
YYYYy: Line number in CONSOL«xox member 
text: 
MISPLACED HARDCOPY STATEMENT IGNORED. 
MISPLACED DEFAULT STATEMENT IGNORED. 
MISPLACED INIT STATEMENT IGNORED. 
IEA196I CONSOL«xx stmt-type: text 
x: Member name suffix 
stmt-type: "HARDCOPY", "DEFAULT", or “INIT" 
text - 
aaaagzaasaa VALUE IGNORED. REASON=Erc. 


DUPLICATE SPECIFICATION IGNORED. 
DUPLICATE aaaaaaaaa VALUE IGNORED. 


ABEND CODES: None 
WAIT STATE CODES: None 


RETURN CODES: 
EXIT NORMAL: 


Register 15 contains 0 


REGISTER CONTENTS ON ENTRY: 


Register 0 - Irrelevant 

Register 1 - Address of a 4% byte field which 
contains the address of the Scan 
Parameter List 


Register 2-12 - Irrelevant 

Register 13 - Address of 72 byte save area 
Register 14 - Return address 

Register 15 - Entry address of IEAVN602 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL : 


Registers 0 - 14 restored to contents upon entry 
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ITEAVN604 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: CONSOLxx Member Exits = Part 3. 


FUNCTION: 
This module gats control from the parser (IEEMB887) 
to set up the Console Data Area with values that were 
specified for UNIT, USE, CON, DEL; SEG, RNUM, RTME; 
UTME and PFKTAB Key words on CONSOLE statement. 
ENTRY POINT: IEAVN604 
PURPOSE : 

To store the user specified data in Console 

Data Area for further processing. 
LINKAGE: PL/AS CALL statement 


CALLERS: 
Parser Module ~- IEEMB887, via the parse 
definitions in IEAVN603 
INPUT: 
Register 1 points to a word which contains address of the 
Scan Parameter List. 
OUTPUT: Updated Console Data Area 
EXIT NORMAL: Returns to the caller. 
EXTERNAL REFERENCES: 
ROUTINES: None 


CONTROL BLOCKS: 





Common Name Macro Name Usage 
CDEF IEAVN100 R,»M 
UCM TEECUCM R 
SCL IEEZB815 R»M 
Index Table IEAVN102 C,D 


KEY = C =~ Create, D - Delete, M - Modify, R - Read 
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IEAVN604 - MODULE OPERATION 


When the parser finds a syntactically valid value for the 
key words specified above, this module is entered to set 
appropriate values in the Console Data Area. 


UNITXT - 
This routine gets control when a value is found for 
the UNIT Key word. 


Set appropriate value in the Console Data Area 
according to the unit type specified. 


USEXT - 
This routine gets control when a value is found for 
the USE Key word. 


Set appropriate value in the Console Data Area. 


CDUXT - 
This routine gets control when a value is found for 
the USE, CON, or DEL key word. 


Set appropriate value in the Console Data Area. 


SGRNTPXT - | 
This routine gets control when a value is found for 
the SEG, RNUM, RTME, UTME, or PFKTAB Key words. 


If the Key word is PFKTAB, store the value in Console 
Data area. 
If the Key word is SEG, RNUM, RTME, or UTME 

Convert the value to binary. 

Set the value in the Console Data Area 
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IEAVN604 - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAVN604 
MESSAGES: None 

ABEND CODES: None 

WAIT STATE CODES: None 


RETURN CODES: 
EXIT NORMAL: 


Register 15 contains 0 


REGISTER CONTENTS ON ENTRY: 


Register 0 - Irrelevant 

Register 1 - Address of a word which 
contains the address of the Scan 
Parameter List 


Register 2-12 - Irrelevant 

Register 13 ~ Address of 72 byte save area 
Register 14 - Return address 

Register 15 - Entry address of IEAVN6046 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 


Registers 0-14 restored to contents upon entry 
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IEAVN610 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: CONSOLxx Statement Validation Module 


FUNCTION: 

To complete the validation of the CONSOLE, 
HARDCOPY, DEFAULT and INIT statements. 
This module receives control to process one 
statement at a time. 


ENTRY POINT: IEAVN610 
PURPOSE: See FUNCTION above. 


LINKAGE : 
IEAVN610 is CALLed using standard system 
linkage conventions. 


CALLERS: IEAVN600, IEAVN601, IEAVN602, IEAVN613 
INPUT: CONSOLxx Data Area (IEAVN100). 
OUTPUT : 


Updated CONSOLxx Data Area (IEAVN100 ) 
Message Service Parameter List (IEAVM101). 


EXIT NORMAL: Returns to the caller. 
EXIT ERROR: Returns to the caller. 
EXTERNAL REFERENCES: 


ROUTINES: 
IEAVN611 - CONSOLE Statement Semantic 
Module Part 1 
IEAVMZ00 - Generalized Message Service 
Module 


CONTROL BLOCKS: 
The following control blocks are used, 
modified or created in this module: 


NAME MAPPING MACRO REFERENCE 
CVT CVT R 

MSGS ITEAVM101 C,»M,D 
CONSDEFN ITEAVN100 M 

IOCM ITECDIOCM R 

UCM ITEECUCM R 

UCB ITEFUCBOB R 

PSA ITHAPSA R 


KEY = R-read, C-create, M-modify, D-delete 


SERIALIZATION: 
None 
SYSGEN = 
LOAD MODULE - IEAVN600 
DISTRIBUTION LIBRARY - AOSCS5 


LY28-1200-4 © Copyright IBM Corp. 1982, 1987 Section 5. Method of Operation 


5-391 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Diagram 55. IEAVN600/IEAVN 610 Part 25 of 53 
IEAVN610 - MODULE OPERATION 





The major sub-routines in this module are listed: 


1. MAINLINE 
- Determines Statement-Type being validated 


2. CONSOLE Sub-routine 

Insures consistency between the Device Type 
in the UCB with the CONSOLxx specifications 
and applies defaults if necessary 

- Checks validity of Device Numbers 

- Calls UCB_FIND to validate Device Number 
against a matching UCB 

- Calls MS_MATCH to determine if the Device 
Type in the UCB matches that specified 
on the UNIT Keyword in CONSOLxx 

- Calls CON_SUPP to determine if the Device 
Type in the UCB is supported as a Console 

- Calls CON_COMP to validate Device Type for 
a Composite Console 

-~ Applies defaults to the valid Console if 
necessary 

- Calls IEAVN611 to do semantic checking for 
the Keywords on the CONSOLE statement 


Note: IEAVN611 calls IEAVN612 to continue 
the semantic checking. 


3. HARDCOPY Sub-routine 
Applies defaults if necessary: 
- Applies default Routing Codes 
~ Applies default Device Number for HARDCOPY LOG 
- Applies default CMDLEVEL 





4. DEFAULT Sub-routine 
Applies default Routing Codes if necessary 


5. INIT Sub-routine 
Validates the INIT statement and applies 
defaults if necessary: 
- Checks validity of MLIM (NTO buffer limit) 
- Checks validity of RLIM (WTOR reply limit) 
- Applies default for AMRF (Action Message 
Retention Facility status 
- Checks UEXIT (WTO user exit status) 
Checks suffix for MPF (Message Processing 
Facility) parmlib member 
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ENTRY POINT NAME: IEAVN610 


MESSAGES: 


IEAVN610 issues the following messages via IEAVM200: 


IEA189I CONSOLxx: 111(,000) IGNORED. Text 
Where: 
xx is the suffix of the CONSOLxx SYS1.PARMLIB 
member being processed when the error was 
recognized. 


111(,000) is the Device Number(s) 
of the CONSOLE statement in error. 


The Text inserts are: 
UNIT NOT SUPPORTED. 
NO IODEVICE STATEMENT FOR ddd. 
Where ddd is the Device Type specified 
111 NOT SUPPORTED AS INPUT DEVICE. 


Where i11 is the Device Number of the 
input device. 


ooo NOT SUPPORTED AS OUTPUT DEVICE. 
Where ooo is the Device Number of the 
output device. 
IEA196I CONSOLxx stmt-type: text. 


Where: 
The stmt-types are: 


111(,000) or INIT 


The text inserts are: 


keyword VALUE IGNORED. REASON=rc 
Where keyword is either: 
MLIM or RLIM 
The Reason Code identifies the situation: 
1. The value does not conform to the 
syntax of the Keyword or the value 
is out of range for the Keyword or 
for the Console's Device Type. 
IODEVICE STATEMENT UNIT APPLIED. REASON=rc 
The Reason Code identifies the situation: 


1. A second Device Number was specified 
on the DEVNUM Keyword, but the UNIT 
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IEAVN610 - DIAGNOSTIC AIDS (Continued) 


specification was not COMP. 


2. The UNIT specification is COMP, but 
the DEVNUM keyword does not have two 
Device Numbers. 


3. The Device Type specified on an 
IODEVICE statement in MVSCP is not 
consistent with the UNIT 
specification on the CONSOLE 
statement of CONSOLxx. 


ABEND CODES: None 
WAIT STATE CODES: None 


RETURN CODES: 
EXIT NORMAL: 
The Return Code in Register 15 is: 
0 Successful processing. 
EXIT ERROR: 
The Return Codes in Register 15 are: 


4 Request is not valid. 

8 Free MSGRT command queue. 

12 Free all (MONITOR and MSGRT) command 
queues. 


REGISTER CONTENTS ON ENTRY: 


Register 0 - Irrelevant 

Register 1 - Address of a 4-byte field that 
contains the address of the 
CONSOLxx Data Area (IEAVN100) 
Irrelevant 

Address of a standard save area 
Return address 

Entry point address of IEAVN610 


Registers 2-12 
Register 13 
Register 14 
Register 15 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 


Registers 0 thru 14 are restored 
to contents at entry. 


EXIT ERROR: 


Registers 0 thru 14 are restored 
to contents at entry. 
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IEAVN611 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: CONSOLE Statement Semantic Module Part 1 


FUNCTION: 

To validate the Keywords on the CONSOLE 
statement and apply defaults if necessary. 
The Keywords ALTERNATE, UNIT, AUTH, USE, AREA; 
CON and DEL are validated in this module. 
This module receives control to process one 
statement at a time. 


ENTRY POINT: IEAVN611 
PURPOSE: See FUNCTION above. 


LINKAGE: 
IEAVN611 is CALLed using standard 
system linkage conventions. 


CALLERS: IEAVN610 
INPUT: CONSOLxx Data Area (IEAVN100 ) 


OUTPUT: 
Updated CONSOLxx Data Area (IEAVN100) 
Message Service Parameter List (IEAVM101). 


EXIT NORMAL: Returns to the caller. 
EXIT ERROR: Returns to the caller. 
EXTERNAL REFERENCES: 
ROUTINES: 
IEAVN612 - CONSOLE Statement Semantic 
Module Part 2 


IEAVM200 - Generalized Message Service 
Module 


DATA AREAS: Console Default Table (IEAVN800) 
CONTROL BLOCKS: 


The following control blocks are used; 
modified or created in this module: 


NAME MAPPING MACRO REFERENCE 
MSGS TEAVM101 M 
CONSDEFN IEAVN10G M 
DEF TMAP ITEAVN10O1 R 
UCM ITEECUCM R 


KEY = R-read, C-create, M-modify, D-delete 


SERIALIZATION: 
None 
SYSGEN = 
LOAD MODULE - ITEAVN60G 
DISTRIBUTION LIBRARY ~ AOSCS5 
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The major sub-routines in this module are listed: 


1. MAINLINE 
Invokes sub-routines to validate keywords for 
this module 
Calls IEAVN612 to continue validation of 
keywords for the CONSOLE statement 


2. ALT_UNIT Sub-routine 
Validates the ALTERNATE Console specification 
and UNIT keyword 
- Checks validity for Subsystem Console 


3. AUTH Sub-routine 
Validates the AUTHority keyword and applies 
defaults if necessary 
- Checks for duplicate Master Console 
- Checks validity for Subsystem and Printer 
Consoles 


4. USE Sub-routine 
Validates the USE Keyword and applies 
defaults if necessary 
- Checks validity for Subsystem, Composite, 
Master, 2740 and Printer Consoles 


5. AREA Sub-routine 
Validates the AREA Keyword and applies 
defaults if necessary 
- Checks validity for Subsystem, Composite, 
Printer and 2740 Consoles 
Calls SRCH_TAB to Search Console Characteristics 
Default Table (IEAVN800) for match on Device Type 
Calls AREA_SD to validate AREA for Status 
Display Console 
Calls AREA_FC to validate AREA for Full 
Capability or Message Stream Console 
Calls AREA_DFT to apply defaults if AREA 
keyword was not specified 


6. CON_DEL Sub-routine 

Validates the CONversational and DELetion mode 
keywords and applies defaults if necessary 

- Checks validity for Subsystem, Composite, 
Printer, 2740 and Display Consoles 

- Calls DEL_MS to validate the DELetion mode 
for Message Stream Consoles and applies 
defaults if necessary 
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IEAVN611 = DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAVN611 


MESSAGES: 


IEAVN611 issues the following messages via IEAVM200: 


IEA195I CONSOLxx LINE yyyyy: 
keyword IGNORED FOR SUBSYSTEM CONSOLE. 


Where: 
xx is the suffix of the CONSOLxx SYS1.PARMLIB 
member being processed when the error was 
resognized. 


yyyyy is the relative position of a line 
within the SYS1.PARMLIB member. 


keyword is either: 


ALTERNATE, AREA, AUTH(MASTER), CON, DEL, 
UNIT or USE 


IEA196I CONSOLxx 111{,000): text 


Where i11(,000) is the Device Number(s) 
of the CONSOLE statement in error. 


The text inserts are: 
AREA VALUE IGNORED. REASON=1 
The Reason Code identifies the situation: 


1. The value is out of range for the 
AREA specification. Each AREA length 
must be four or more lines. 


keyword IGNORED. REASON=rc 
Where keyword is either: 
AREA, AUTH, CON or DEL 
The Reason Code identifies the situation: 
1. AREA, CON or DEL was specified for a 
UNIT of COMP, PRT», or 2740. The AREA, 


CON, or DEL specification is ignored. 


2. AUTH was specified for a UNIT of PRT. 
AUTH is ignored. 


3. The AREA specification was not valid. 
The total out-of-line AREA specified 


can not exceed the screen size of the 
device. 


USE( xx) FORCED. REASON=rc 


Where xx indicates the value the USE 
parameter was changed to either: 


FC - Full Capability 
MS - Message Stream 
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IEAVN611 = DIAGNOSTIC AIDS 


(Continued ) 


The Reason Code identifies the situation: 


1. A statement contained AUTH(MASTER) 
and USE(MS) or USE(SD). Since the 
Master Console must be full 
capability, USE(FC) is forced. 


2. A definition contained UNIT(COMP) or 
UNIT(2740) but the USE specification 
was not full capability. USE(FC) is 
forced. 

3. A USE of Full Capability or Status 
Display was specified for a Printer 
Console. USE(MS) is forced. 

DUPLICATE MASTER. AUTH( INFO) FORCED. 


DEL(RD) FORCED. 


ABEND CODES: 


None 


WAIT STATE CODES: 


None 


RETURN CODES: 
EXIT NORMAL: 
The Return Code in Register 15 is: 
0 Successful processing. 
EXIT ERROR: 
The Return Codes in Register 15 are: 
8 Free MSGRT command queue. 


12 Free all (MONITOR and MSGRT) command 
queues. 


Note: Return Codes 8 and 12 are generated 
within IEAVN612 and passed back to the 
caller of this module. 


REGISTER CONTENTS ON ENTRY: 


Irrelevant 

Address of a 4-byte area that 
contains the address of the 
CONSOLxx Data Area (IEAVN100) 
Irrelevant 


Register 0 - 
Register 1 - 


Registers 2-12 - 


Register 13 - Address of a standard save area 
Register 14 - Return address 
Register 15 - Entry point address of IEAVN611 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 


Registers 0 thru 14 are restored 
to contents at entry. 
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IEAVN611 - DIAGNOSTIC AIDS (Continued) 
EXIT ERROR: 


Registers 0 thru 1¢ are restored 
to contents at entry. 
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DESCRIPTIVE NAME: CONSOLE Statement Semantic Module Part 2 


FUNCTION: 

To validate the keywords on the CONSOLE 
statement and apply defaults if necessary. The 
LEVEL, MFORM, MONITOR, MSGRT, PFKTAB, RNUM, RTME;, 
UTME, SEG and ROUTCODE are validated in this module. 
This module receives control to process one 
statement at a time. 


ENTRY POINT: IEAVN612 
PURPOSE: See FUNCTION above. 
LINKAGE : 
IEAVN612 is CALLed using standard 
system linkage conventions. 
CALLERS: IEAVN611 
INPUT: CONSOLxx Data Area (IEAVN100) 
OUTPUT: 
Updated CONSOLxx Data Area (IEAVN100). 
Message Service Parameter List (IEAVM101). 
EXIT NORMAL: Returns to the caller. 
EXIT ERROR: Returns to the caller. 
EXTERNAL REFERENCES: 
ROUTINES: 
IEAVM200 - Generalized Message Service 
Module 
DATA AREAS: Console Default Table (IEAVN800) 
CONTROL BLOCKS: 


The following control blocks are used, 
modified or created in this module: 


NAME MAPPING MACRO REFERENCE 
MSGS IEAVM101 M 
CONSDEFN IEAVN100 M 
DEFTMAP IEAVN10O1 R 
UCM IEECUCM R 


KEY = R-read, C-create, M-modify, D-delete 


SERIALIZATION: 
None 
SYSGEN = 
LOAD MODULE - IEAVN600 
DISTRIBUTION LIBRARY - AOSCS 
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IEAVN612 ~ MODULE OPERATION 


The major sub-routines in this module are listed: 


1. MAINLINE 
Invokes sub-routines to validate keywords for 
this module 


2. LVL_MFRM Sub-routine 
Validates the LEVEL and MFORM keywords and 
applies defaults if necessary 
- Checks validity for Subsystem Console 


3. MON_MGRT Sub-routine 
Validates the MONITOR keyword 
- Checks validity for Subsystem Console 
Validates the MSGRT keyword 
- Chacks validity for Subsystem and Printer 
Consoles 


4. PFKTABLE Sub-routine 
Validates the PFKTAB Keyword 
- Checks validity for Subsystem, Composite, 
Printer and 2740 Consoles 


5. RN_T_SEG Sub-routine 
Validates the RNUM, RTME, UTME and SEG keywords 
and applies defaults if necessary 
- Checks validity for Subsystem, Composite, 
Printer, 2740, Display and 3270-X 
Consoles 


6. ROUTCODE Sub-routine 
Validates the ROUTCODE keyword and applies 
defaults if necessary 
- Checks validity for Subsystem and Master 
Consoles 
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IEAVN612 - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAVN612 


MESSAGES: 
IEAVN612 issues the following messages via IEAVM200: 
IEA195I CONSOLxx LINE yyyyy: 
keyword IGNORED FOR SUBSYSTEM CONSOLE. 
Where: 
xx is the CONSOLxx SYS1.PARMLIB member 
being processed when the error was 


recognized. 


yYVYY is the relative position of a line 
within the SYS1.PARMLIB member. 


keyword is either: . 
LEVEL, MFORM, MONITOR, MSGRT, PFKTAB, 
RNUM, ROUTCODE, RTME, UTME or SEG 
IEA196I CONSOLxx 111(,000): text 


Where i11{,000) 1s the device number(s) 
of the CONSOLE statement in error. 


The text inserts are: 
keyword VALUE IGNORED. REASON=rc 
Where keyword is either: 
RNUM, RTME, UTME or SEG 
The Reason Code identifies the situation: 
1. The value does not conform to the 
syntax of the Keyword or the value 
1s out of range for the Keyword or 
for the Console's Device Type. 
Keyword IGNORED. REASON=rc 
Where keyword is either: 
MSGRT, PFKTAB, RNUM, RIME, UTME or SEG 
The Reason Code identifies the situation: 
1. PFKTAB, RNUM, RTME, UTME or SEG was 
specified for a UNIT of COMP, PRT, 
or 2740. The PFKTAB, RNUM;, RIME, SEG OR 
UTME specification is ignored. 


2. MSGRT was specified for a UNIT of 
PRT. MSGRT is ignored. 


3. MSGRT was specified for a UNIT of 
COMP. MSGRT is ignored. 


ABEND CODES: None 
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IEAVN612 - DIAGNOSTIC AIDS (Continued) 


WAIT STATE CODES: None 


RETURN CODES: 
EXIT NORMAL: 
The Return Code in Register 15 is: 
0 Successful processing. 
EXIT ERROR: 
The Return Codes in Register 15 are: 


8 Free MSGRT command queue. 
12 Free all (MONITOR and MSGRT) command queues. 


REGISTER CONTENTS ON ENTRY: 


Register 0 - Irrelevant 

Register 1 ~ Address of a 4-byte area that 
contains the address of the 
CONSOLxx Data Area (IEAVN100) 
Irrelevant 

Address of a standard save area 
Return address 

Entry point address of IEAVN612 


Registers 2-12 
Register 13 
Register 14 
Register 15 
REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 


Registers 0 thru 14 are restored 
to contents at entry. 


EXIT ERROR: 


Registers 0 thru 14 are restored 
to contents at entry. 
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TEAVN613 - MODULE DESCRIPTION 


FUNCTION: 
This module receives control when all CONSOLxx records 
have been read. IEAVN613 
calls IEAVN610 to apply defaults if no HARDCOPY, 
DEFAULT or INIT statement is specified 1m CONSOLxx. 
It selects a new master console if needed, validates all 
alternate consoles and calls IEAVN614¢ to initialize 
the UCM control blocks. 
ENTRY POINT: IEAVN613 
PURPOSE: See function 
LINKAGE: PL/AS Call statement 
CALLERS: IEAVN600 
INPUT : 
Register 1 points to a word that contains the 
address of the CONSOLxx data area ( IEAVN100) 
OUTPUT: The CONSOLxx data area (IEAVN100) is updated 
EXIT NORMAL: Returns to the caller. 
OUTPUT: The CONSOLxx data area is updated. 
EXIT ERROR: Returns to the caller 
OUTPUT: Reason code is set in the CONSOLxx data area. 
EXTERNAL REFERENCES: 
ROUTINES: 
IEAVN610 - Console validation routine 


IEAVN614 - UCM initialization routine 
IEAVM200 ~- Generalized message service routine 


CONTROL BLOCKS: 


Common name Macro Name Usage 
CDEF IEAVN100 R,M 
MSGS IEAYM101 C,»D»M 
UCB IEFUCBOB R 
UCM IEECUCM R 


KEY = C-CREATE, D-DELETE, M-MODIFY, R-READ 


TABLES: No tables used. 
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ITEAVN613 - MODULE OPERATION 


IEAVN613 receives control with register 1 pointing 

to a word that contains the address of the CONSOLxx data 
area. This module is called to validate the configuration 
of the consoles. 


1.Validates HARDCOPY, DEFAULT and INIT statement. 


If no HARDCOPY statement is specified, calls IEAVN610 
to apply the default values for the statemant. 


If no DEFAULT statement is specified, calls 
IEAVN610 to apply the default values for the statement. 


If no INIT statement is specified, calls IEAVN610 
to apply the default values for the statement. 


2.If the hardcopy log is not SYSLOG, then validates 
the hardcopy device. 
If the hardcopy console is not a console or a 
display console, or has no UCB or a bad UCB 
(note. throughout this module ‘bad UCB' means 
that the device type indicated by the UCB is 
not a supported MCS console), 
issues the message IEA194I, and uses SYSLOG 
as the hardcopy log. 


3.Selects a new master console if the master specified 
in the CONSOLxx is powered off, the master is not 
valid (1.e. no UCB or bad UCB) or no master is defined 
in CONSOLx~x. 


If the master console is powered off, issues the message 
IEA190I to indicate the reason for not using 
the specified master console. 


If the master is not valid or the master was powered 
off, the first input-output capability 

(full capability) online console is picked 

from the master's alternate console chain and 

that console is used as a new master. ROUTCODE, LEVEL 
and AUTH of the old master console 

are merged into the new master console's ROUTCODE; 
LEVEL and AUTH. Issues the message IEA19I1I 

to indicate which console is chosen as the master. 


If no master is defined in CONSOLxx or no console is 
available to be used as a new master in the master's 
alternate console chain, the first full capability 
online console specified in CONSOLxx is selected. 
ROUTCODE, LEVEL and AUTH 

of the old master are merged into the 

new master console's ROUTCODE, LEVEL and AUTH. 
Issues the message IEA191I to 

indicate which console is chosen as the new master. 


If no online full capability console is available but 
there is at least one offline full capability console 
available which may be used as a new master, sets a 
reason code to indicate that there 

is no online full capability console and also for 
specification of a new CONSOLxx member or a re-ipl. 


If no valid full capability console is available to 


be used, set a reason code to indicate that no 
master could be selected and also request specification 
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IEAVN613 = MODULE OPERATION § [Continued) 


of a new CONSOLxx member. 
4.Validates all consoles alternate. 


If the console is a subsystem console, the next 
console is processed. 


If no alternate console is defined for the console or 

a bad alternate console is assigned to the console 
(meaning a printer is used as the alternate for 

a full capability console or the alternate console 

is not valid), uses the user defined mastoar as 

the alternate console if it is a valid online or 
offline console. Otherwise uses the new selected master 
as the alternate console. Processes the 

next console. 


5.Calls ITEAVN614 to build UCM fixed extension base, 
UCM fixed extension save area, UCM pageable extension 
base, UCME pageable extension and UCME fixed extension 
and initialize the UCM control blocks. 
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Cc IEAVN613 = DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAVN613 


MESSAGES: 


IEAVN613 issues the following messages via IEAVM200. 
IEA1L88&I - CONSOLxx: NO MASTER CONSOLE SPECIFIED 
Where: 
xx - suffix for CONSOLxx member 


IEA190I - CONSOLxx: MASTER CONSOLE xxx(,»,yyy) WAS OFFLINE DURING 
IPL 
Where: 
xx - suffix for CONSOLxx member 
xxx( syyy) - console device number(s ) 


IEA191I - CONSOLE xxx(,yyy) text AS MASTER CONSOLE 
Where: 
xxxl syyy) - console device number(s ) 
text - SELECTED or DEFINED 


IEA192ZI - CONSOLxx 111,000): ALTERNATE DEFAULTED TO xxx( »yyy). 
REASON=rc 

Where: 

xx - suffix for CONSOLxx member 

111,000) - console device number(s) 

xxx( yyy) - console device number(s) 

re = 1 - the alternate console for the console 111( ,000) 
does not have a CONSOLE statement in CONSOLxx. 
The master console xxx(,yyy) is used as the 

Ye alternate console. 

re = 2 - the alternate console for the console 111[ ,000) 
1s not a valid console. 
The master consola xxx(,yyy) is used as the 
alternate console. 


re = 3 - the alternate console for the console 111(,000) 
has an invalid operating mode. 
The master console xxxl(,yyy) 1s used as the 
alternate console. 

re = 4% - no alternate console for the console 111,000) 


is defined. 
The master console xxx(,yyy) 1s used as the 
alternate console. 


IEA194I - CONSOLxx xxx(, yyy): HARDCOPY DEFAULTED TO SYSLOG, 
REASON=rc 
Where: 
xx - suffix for CONSOLxx member 
xxx( yyy) - console device number(s) 


re =] ~ xxx(,yyy) is not a console (ie. no console 
statement for xxx(,yyy)) 

re = 2 ~ xxx(,yyy) is not valid 

re = 3 - x or yyy 1s a display console 


ABEND CODES: None 
WAIT STATE CODES: None 


RETURN CODES: 


( EXIT NORMAL: 


J in Register 15 
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IEAVN613 - DIAGNOSTIC AIDS (Continued) 


EXIT ERROR: 


G4 in Register 15 


REGISTER CONTENTS ON ENTRY: 


Register 0 - Irrelevant 

Register 1 - Address of a G-byte field that contains 
address of the CONSOLxx data area 

Registers 2-12 - Irrelevant 

Register 13 - Address of a 72-byte save area 

Register 14 - Return address 


Register 15 - Entry point address of IEAVN613 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 

Registers 0-14 - Restored to contents upon entry 
EXIT ERROR: 


Registers 0-14 - Restored to contents upon entry 
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IEAVN613 - STEP 01 


IEAVN600 


This module receives control when all 
N CONSOLxx records have been read. IEAVN613 
calls IEAVN610 to apply defaults if no 


7 HARDCOPY, DEFAULT or INIT statement is 
ITEAVN613| | specified in CONSOLxx. It selects a new 
master console if needed, validates all 
alternate consoles and calls IEAVN614 to 
initialize the UCM control blocks. 


PARAMETERS 





o1 Console Configuration 
Validation 


A. Calls IEAVN610 1 no HARDCOPY, DEFAULT 
or INIT statement is specified. If the 
hardcopy is not SYSLOG, validates the 
hardcopy device. 


7#c4oy 
\r—7 VALHDI: 02 


- Selects a new master console if the 
master was powered off, the master is 
not valid (no UCB is associated with 
that device number or UCB could not be 
used) or no master is defined in the 
CONSOLxx data area. 


feo 
N\rms7Z SELMSTR: 03 


. Validates all alternate consoles. 


7Uu\ 
\r—7 ALTCONS: 04 


. Calls IEAVN614 to build UCM fixed 
extension base, UCM fixed extension save 
area, UCM pageable extension base, UCME 
pageable extension and UCME fixed 
extension and initialize the UCM control 
blocks. 


sLN 
\r—ws27 JEAVN614 


E. Return to caller 
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IEAVN613 = STEP 02 
\ 
02 > 02, Calls IEAVN610 if no 
/ HARDCOPY, DEFAULT or INIT 
VALHDI statement is specified. If 
the hardcopy is not SYSLOG, 
validates the hardcopy 
device. 
IEAVN100 Sie >| A. If mo HARDCOPY, no DEFAULT or no INIT \IEAVN100 
\ statement is specified, calls IEAVN610 / 
















CONHCPYB CONDFLTB / to apply the default values for the CONSTFLG 

CONINITB CONHCDEF statement. CONHCPYB 

CONDFDEF CONINDEF CONDFLTB 

sN CONINITB 

IEAVN100 pr--------- >| B. If the hardcopy log is not SYSLOG, then \ITEAVN100 
: \ validates the hardcopy device. If the 

CONHSYSL CONUNTT1 / hardcopy console is not a console» is a CONHSYSL 


CONDEVS2 CONBDUCB display console, or has no UCB or a bad 
UCB (note. A "bad UCB' means that the 


device type indicated by the UCB is not 


CONUCB1L CONUCB2 





UCB : a@ supported MCS console), issues the 
at message IEA194I, and uses SYSLOG as the 
IEAVN100 C. Raturn to subroutine's caller 





CONHDV2 CONHDEV1 
CONHDEV2 


Selects a new master console 
if the master was powered 
off, the master is not valid 
(no UCB is associated with 
that device number or UCB 
could not be used) or no 
master is defined in the 
CONSOLxx data area. 









IEAVN100 protec >| A. If the master is not valid or the master 
was powered off, the first input-output 
capability (full capability) online 
console is picked from the master's 
alternate console chain and that console 


is used as a new master. 













sv 


\r—/ SEARCHAL: 05 


. If no console is available to be used as 
a new master in the master's alternate 
console chain, the first full capability 
online console specified in CONSOLxx is 

selected. 


ITEAVN100 


CONMSTRP CONUCB1 
CONUCB2 
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IEAVN613 - STEP 03C 


sy 
\-—/ SERCHTOP: 06 
TEAVN100 Se > 
C. If no master is defined in CONSOLxx, the 
CONMASTR first full capability online console 
. specified in CONSOLxx is selected. 
7L—AN 
\—V/ SERCHTOP: 06 


D. If no online full capability console is \TEAVN100 







































available but there is at least one 
offline full capability console 
available which may be used as a new 
master, sets a reason code to indicate 
that there is no online full capability 
console and also for specification of a 
new CONSOLxx member or a re-ipl. If no 
valid full capability is available to be 
used, set a reason code to indicate that 
no master could be selected and also 
request specification of a new CONSOLxx 
member. 
IEAVN100 \| E. If the new master is selected, ROUTCODE, \TEAVN100 
/ LEVEL and AUTH of the old master console 
CONMSTRP CONAUTH are merged into the new master console's TeoNauTH 
CONROUT CONLEVEL ROUTCODE, LEVEL and AUTH. Issues the CONROUT 
message IEA191I to indicate which CONLEVEL 
console is chosen as the master. CONDISPA 
F. Return to subroutine's caller 
\ 
04 > Validates all alternate 
/ consoles. 
ALTCONS 
ITEAVN100 aj >| A. If the console is a subsystem console, \TEAVN100 
\ the next console is processed. 
CONSPEC CONUNTTI1 / 
CONBDUCB CONADEV1 If no alternate console is defined for 
CONADEV2 CONDISPE the console or a bad alternate console 
CONDISPK is assigned to the console ( meaning a CONALTN2 
printer is used as the alternate for a 
TEAVNLOO full capability console or the alternate 
console is not valid}, uses the user 
CONNUMEN CONMSTRP defined master as the alternate console 
CONFRSTP CONDEVS1 if it is a valid online or offline 
CONDEVS2 CONDEVN1 console. Otherwise uses the new selected 
CONDEVN2 CONALTNI1 master as the alternate console. 
CONALTN2 Processes the next console. 
B. Return to subroutine's caller 
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IEAVN613 - STEP 05 


Goes through the master's 


alternate chain and locates 





ITEAVN100 an online full capability 
console. 


ITEAVN100 Se >| A. Searches until an online full capability 
\ console is located, or a loop is formed 
CONSLID CONBDUCB / or no alternate is defined, or alternate 
CONADEV1 CONADEV2 is not valid, or no console entry is 
associated with that alternate console. 
IEAVN100 





B. Return to subroutine's caller 
CONALTN1 CONALTN2 


Goes through the console 
array from the beginning and 
locates an online full 
capability console 


TEAVN100 . Gat a console entry from the beginning 

of the console array. If the console 
CONSFEC CONBDUCB entry has not yet been processed, 
CONDISPK validates the console. If the console is 

not a subsystem console and is an online 
ITEAVN100 full capability console, selects that 
console. Otherwise get next available 
consola. 





CONNUMEN CONFRSTP 


- Return to subroutine's caller 
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JEAVN6G14 - MODULE DESCRIPTION 


FUNCTION: 
Builds extensions to the UCM and initializes the UCM control 
blocks. 
ENTRY POINT: IEAVN614 
PURPOSE: See function 
LINKAGE: PL/AS Call statement 
CALLERS: IEAVN613 
INPUT: 
Register 1 points to a word that points 
to the address of the CONSOLxx data area 
(IEAVN1OO ) 
OUTPUT: The UCM control blocks are initialized. 
EXIT NORMAL: Returns to the caller. 
OUTPUT: 
UCM base, MCS prefix, UCMEs, UCM fixed and 
pageable extension base and its extensions 
are initialized. 
EXTERNAL REFERENCES: 
ROUTINES: None 


CONTROL BLOCKS: 


Common name Macro Name Usage 
COEF IEAVN100 R 
BASEA IEEBASEA R 
SNPL IEFEZB807 M 

UCM IEECUCM C»M>R 
UCB IEFUCBOB M>R 
CVT CVT R 
CMDELEM IHACTM R 


KEY = C-CREATE, D-DELETE, M-MODIFY, R-READ 


TABLES: No tables used. 
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IEAVN614 - MODULE OPERATION 


IEAVN614 receives control with register 1 pointing 

to a word that contains the address of the CONSOLxx data 
area. IEAVN613 calls IEAVN614¢ to build and initialize the 
UCM control blocks. 


1.Builds the UCM base and extensions 


Recalculates the last UCME address and reinitializes the 
last UCME pointer (UCMVEL) in the UCM base. 


Builds the UCM fixed extension base, UCME fixed extensions, 
and UCM fixed extension save area from storage 
obtained from Subpool 245. Initializes the storage with 
x'00'. Sets the address of the UCM fixed extension base in 
the UCM base. Puts the UCM fixed extension base's id, 

the address of the first UCME fixed extension, 

the address of the last UCME fixed extension, the length of 
a UCME fixed extension, and the address of the UCM fixed 
extension save area in the UCM fixed extension 
base. 


Builds the UCM pageable extension base and the UCME pageable 
extension from storage obtained from Subpool 241. 

Initializes the storage with x'00'. Puts the address of 

the UCM pageable extension base in the UCM fixed 

extension base. Initializes the UCM pageable extension base's 
id, the address of the first UCME pageable extension, the 
address of the last UCME paceable extension, and the length 
of a UCME pageable extension in the 

UCM pageable extension base. 





2.Initialize all UCMEs and their extensions 


Initializes each UCME, UCME fixed extension 
and UCME Pageable extension with the data from the 
valid console entry in the CONSOLxx data area. If the 
console is a composite console, sets AUTH 

in the input half of the composite console. Sets 
ROUTCODE, MFORM and the command queue in the output 
of the composite console. Sets USE and LEVEL values 
in both the input and output halves of the composite 
console. 


-~ If the console is online, turns on UCBSYSR to indicate 
that the device is being used as a console 


~ If the master console is being processed, sets the 
address of the master's UCME in the MCS Prefix 
( UCMMCENT ) 


- If the console is a display console, turns on UCMSYSF 
to indicate that display consoles exist. If the console 
is an active display console, turns on UCMSYSN and 
UCMSYSB to indicate that an active display console 
exists and a hardcopy log is required. Increments 
console count. 


If the console is a non-display console but active, 
increment the active console count. 


The UCME's chain is processed the second time to set the 
alternate consoles address. If the console is not a 
subsystem console, locates the 
UCME address of the alternate console. If the alternate 
console is a composite, calculates the other 
half of the alternate console's address. 
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TEAVN614 - MODULE OPERATION (Continued) 


Otherwise, sets the address of the alternate output UCME 
to zero. 


3.Initializes the MCS Prefix, the UCM Fixed Extension Base 
and the UCM Pageable Extension Base 


If the hardcopy is a device, invokes a routine to 

locate the address of the hardcopy console and initializes 
UCMHCUCM with that address. Initializes UCMSYSC (in byte 1 
of system control flags), UCMSDSIA, UCMSDSIB (in SDS flag) 
with the CMDLEVEL in the CONSOLxx data area. 

If hardcopy support is required and NOCMDS is specified, 
forces the hardcopy to accept CMDS. Copies the 

hardcopy’s routing codes into UCMFHCRT. 


Copies the default routing codes into UCMOWTOR 
of the UCM Pageable Extension Base. 


4.Initializes the UCM base, the UCM fixed extension 


base and the UCM pageable extension base with data 
from INIT statament. 
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IEAVN614 = DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAVN614 
MESSAGES: None 

ABEND CODES: None 

WAIT STATE CODES: None 
RETURN CODES: None 


REGISTER CONTENTS ON ENTRY: 


Register 0 - Irrelevant 
Register 1 - Address of a 4-byte field that contains 
address of the CONSOLxx data area 


Registers 2-12 - Irrelevant 

Register 13 - Address of e 72-byte save area 
Register 14 - Return address 

Register 15 - Entry point address of IEAVN614¢ 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 


Registers 0-14 - Restored to contents upon entry 
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TEAVN614 - STEP 01 


IEAVN613 
Builds extensions to the UCM and 
XN initializes the UCM control blocks. 


PARAMETERS 





UCM initialization 


A. Build UCM fixed extension base, its 
extensions, UCM pageable extension base 
and its extensions 


sis 
\r—7Z7 BUILDEXT: O02 


- Initialize all UCMEs and its extensions 


seu—\ 
\r—7 ICONSOLE: 03 


. Initialize MCS prefix, UCM fixed and 
pageable extension bases for the 
HARDCOPY and DEFAULT statements 


sey 
\r—7 HCPYDFLT: 04 


. Initialize UCM base and pageable 
extension base for the INIT statement 


sy 
\-—7/ INITSTMT: 05 


. Return to caller 
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TEAVN614 - STEP 02 








\ 
02 > Builds UCM extension bases 
/ and their extensions 
BUILDEXT 
ITEAVN100 J =----~----- >| A. Recalculates the last UCME address and \UCM 
\ reinitializes the last UCME pointer / 
CONSPEC CONDEVS1 / (UCMVEL) in the UCM base. 
CONDEVS2 CONBDUCB 
IEAVN1LOO 





CONNUMEN CONFRSTP 


UCM 











UCMVEA UCMVEZ 






UCM Z| a<~--2---- >| B. Builds the UCM fixed extension base, 
\ 

UCMFEXTA UCMFSAVE f 

UCMEFEXT 


UCM 





UCMBFEXT UCMFE1ST 
UCMFELEN UCMFELST 






C. Builds the UCM pageable extension base 
and the UCME pageable extension in 
storage obtained from Subpool 241. 
Initializes the storage with x'00'. Puts 
the address of the UCM pageable 
extension base in the UCM fixed 
extension base. Initializes the UCM 
pageable extension base's id, the 
address of the first UCME pageable 
extension, the address of the last UCME 
pageable extension, and the length of a 
UCME pageable extension in the UCM 
pageable extension base. 


UCMPUCMP 


UCM 
UCMPEXTA UCMEPEXT 


UCM 


UCMPE 1ST 
UCMPE LEN 
UCMPELST 





UCMFPPTR UCMPE1ST 
UCMPELEN 






D. Return to subroutine's caller 


UCME fixed extensions, and UCM fixed 

extension save area in storage obtained UCMFUCMF 
from Subpool 245. Initializes the UCMFE1ST 
storage with x'00'. Sets the address of UCMFELEN 
the UCM fixed extension base in thea UCM UCMFELST 
base. Puts the UCM fixed extension UCMFSAVP 
base's id, the address of the first UCME 

fixed extension, the address of the last 

UCME fixed extension, the length of a 

UCME fixed extension, and the address of 

the UCM fixed extension save area in the 

UCM fixed extension base. 
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IEAVN614 = STEP 03 
\ 
03 > Initializes each UCME, UCME 
/ Fixed Extension and UCME 
IEAVN100 ICONSOLE Pageable Extension with data 
\ from a console entry in the 





CONFRSTP / CONSOLxx data area. 


A. Initializes each UCME, UCME fixed 
extension and UCME Pageable extension 
with the data from the valid console 
entry in the CONSOLxx data area. If the 
console is a composite console, sets 
AUTH in the input half of the composite 
console. Sets ROUTCODE, MFORM and the 
console command queue in the output half 
of the composite console. Sets USE and 
LEVEL values in both the input and 
output halves of the composite console. 


If the console is online, turns on 
UCBSYSR to indicate that the device is 
being used as a console 


If the master console is being 
processed, sets the address of the 
master's UCME in the MCS Prefix 

( UCMMCENT ) 


If the console is a display console, 
turns on UCMSYSF to indicate that 
display consoles exist. If the console 
1S an active display console, turns on 
UCMSYSN and UCMSYSB to indicate an 
active display console exists and a 
hardcopy log is required. Increments 
console count. 


IEAVN100 ey >| B. If the console is a non-display console \UCM 

\ but active, increment the active console / 
CONSPEC CONDEVS2 / count. 
CONBDUCB 


The UCME's chain is processed the second 
time to set the alternate consoles 
address. If the console is not a 
subsystem console, locates the UCME 
address of the alternate console. If the 
alternate console is a composite, 
calculates the other half of the 
alternate console's address. Otherwise, 
sets the address of the alternate output 
console to zero. 








UCM 






UCMVEZ 





UCMVEA 
UCMUCB 


C. Return to subroutine's caller 


\N 7 
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IEAVN614 - STEP 904 







Initializes the MCS prefix 
and the UCM Fixed Extension 
Base for the HARDCOPY 

statement. Initializes the 
MCS prefix and the UCM 

Paceable Extension Base for 
the DEFAULT statement. 


0% > 
7 
HCPYDFLT 












LEAVN100 proc oon >| A. If the hardcopy is a device, invokes a 
routine to locate the address of the 
hardcopy console and initializes 
UCHHCUCM with that address. Initializes 
UCMSYSC (in byte 1 of system control 
flags), UCMSDS1A, UCMSDS1B (in SDS flag) 
with the CMDLEVEL in the CONSOLxx data 
area. If hardcopy support is required 
and NOCMDS is specified, forces the UCMFHCRT 
hardcopy to accept CMDS. Copies the UCMOWTOR 
hardcopy's routing codes into UCMFHCRT. 





CONHSYSL CONHCMDL| : 
CONHDV2 CONHDEV1| : 


UCM 








a 
UCMSYSB UCMHCUCM 


TEAVN190 









CONHSTCM CONHINCM 
CONHCMDS CONHROUT 
CONDROUT 


UCM 


Copies the default routing codes into 
UCMOWTOR of the UCM Pageable Extension 
Base. 






B. Return to subroutine's caller 







Initializes the UCM base and 
the UCME pageable extension 
for the INIT statement 






INITSTMT 







\| A. The MLIM and RLIM limits are set in 
UCMNQLM and UCMRQLM. MLIM and RLIM 
values are copied into UCMNQLM1 and 
UCMRQLM1. AMRF, UEXIT, PFK and MPF 
values are copied from the CONSOLxx data 
to UCMAMRFC, UCMFEXIT, UCMPPFKM and 
UCMPMPFM. MN command queue anchor is 
copied into the Scheduler nip parameter 
list (SNPL). 


TEAVN1O0 


CGNIMLIM CONIRLIM 
CONIAMRF CONIUXIT 
CONIMPF CONIPFK 

CONIMN@ 

























. Return to subroutine's caller 





5-420 MVS/XA System Init Logic LY28-1200-4 © Copyright IBM Corp. 1982, 1987 











“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


LY28-1200-4 © Copyright IBM Corp. 1982, 1987 Section 5. Method of Operation 5-421 


o1o7] wy waiskg VX/SAN ZZP-S 


L861 ‘TR6T “90D WAT 14BUAdoD © F-O0ZI-8ZAT 


Diagram 56. Appendate Name Table Initialization (IEAVNP16) Part 1 of 2 


IEAVNIPM 
(Step 34) 


Input Process 











Process RER and RDE 
system parameters in 
IEASYSxx. 










Internal table 


System appendage 
names 
SYS1.PARMLIB 


|IEAAPPOO 
IEASYSXX 











CVTAIDVT 


Appendage name table 
__ C—____—i*?r 


End-of-extrent (Ds 


SSS 
Start 1/O [Ds 
_ 


ee 
Channel end | Ds 
TTT 


Abnormal end IDs 
&K—K¥€éeRNRTRTFTtT 



















Build table of user-written 
—EXCP appendages that can 
be used by unauthorized 
programs. 
























3 Build CVAF table. CVTCVAF 





CVAF table 


Branch entry 
point to 
ICVTSTOO 








Branch entry 
point to 
ICBCMMOO 










IEFENFFX 


ENF service 
router 






Branch to ENF to 
establish listeners for 
DASD volume unload 
events and SOA 
shortage events. 







IEAVNIPM 





c U 
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Diagram 56. Appendate Name Table Initialization (IEAVNP16) Part 2 of 2 


Extended Description Module Label 
IEAVNIPM calls the data management RIM, IEAVNPI6, 

to build a table of user-written EXCP appendages that can be 

used by unauthorized programs. 


In order for a program to use a user-written EXCP appendage 
(for example, a start 1/O routine) during OPEN processing, 
one of the following conditions must exist: 


@ The program is operating under system protect key 0-7. 


@ The program is authorized under the authorized program 
facility (see Diagram [EAVNPAS). 


@ The ID of the user-written EXCP appendage is in the 
appendage name table. The data management RIM builds 
this table as described in the next paragraph. 


{IEAVNP16 


1 _=+‘The RIM processes the RER and RDE parameters in 
SYS1.PARMLIB member IEASYSxx. 


2 The data management RIM contains an internal table of 
EXCP appendage names used by system programs 
operating in a problem program state. (For the format of the 

EXCP appendage name table, refer to Open/Close/EOQV 
Logic.) The RIM copies the system appendage |Ds into the 
appendage name table. The installation specifies the names 
of the user-written appendages in member |EAAPPOO of 
SYS1.PARMLIB. The RIM reads records from |EAAPPOO 
and copies the user-written appendage IDs into the ap- 
pendage name table. The RIM places the address of the 
appendage name table in field CVTAIDVT of the CVT. 
Data management’s OPEN processing will check the ap- 
pendage name table if it receives a request for an EXCP 
appendage from an unauthorized program. 


IEAVNP16 CPYPRIME 


IEAVNP16 MOVEID 


Cc 


Extended Description Module Label 
3 The RIM issues a GETMAIN for 4096 bytes of CSA 
and uses 28 bytes to build the common VTOC access 
facility (CVAF) table containing branch entry points to 
CVAF modules ICVTSTOO and ICBCMMOO. (Refer to 
CVAF Diagnosis Reference for additional information.) 
The RIM places the address of the CVAF table in field 
CVTCVAF of the CVT. The Rim uses the remaining 
4068 bytes to construct VTOC information blocks. 


4 = The RIM branches to ENF to: IEFENFFX 


1. establish CVAF module ICBLSNOO as a listener for 
DASD volume unload events, 

2. establish media manager ICYELE as a listener for 
SQA shorage events. (Refer to MVS Media 
Manager Diagnosis Guide and Reference for 
additional information.) 


For information concerning the logic of IEFENFFX, 
the ENF service router refer to System Logic Library. 
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Diagram 57. Master Scheduler RIM (IEAVNP13) Part 1 of 4 


IEAVNIPM 
(Step 35) 


Process 





Input 


NVT 


NVTPTAB 


PARMTAS8B 





1 Store SMF 
SYS1.PARMLIB 
member name, 





2 Store the suffixes for 
the subsystem 
SY S1.PARMLIB 
CMD= mem bers. 





3 Store the automatic 
commands. 


SYS1.PARMLIB 4 = Locate the subsystem 
interface routine, 
1EACMDOO 


CC 





Output 


VT MSRDA (BASEA) 
CVTMSER 


MSSCHED 
SMF table 


Length of table 
Number of entries 


C’'SMFPRMxx’ 
entry: 


Scheduler NIP 
‘parameter list 


SNPCMD 


Automatic 
commands 


. SESCT 


JESSSREQ 
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Diagram 57. Master Scheduler RIM (IEAVNP13) Part 2 of 4 


Module Label 


Some information passed to NIP in the form of system para- 


‘meters and SYS1.PARMLIB members will be used during 


master scheduler and timer initializations. To obtain this 
information and store it for later use NIP calls the master 
scheduler RIM, IEAVNP13. 


. 1 Master scheduler initialization uses SMF parameters 


specified in the SMFPRMxx member of SYS1.PARM! |B 
Using the SMF system parameter, the 

Installation can specify the suffix for the SMFPRMxx 
member, The master scheduler R!M obtains the suffix value 
from field SMF in PARMTAB. Then, the RIM builds a 
table that contains the SMFPRMxx member name specified. 
If the installation does not specify a suffix, the RIM uses 
the default member name SMFPRMOO. The RIM places the 
address of the SMF parameter table in field MSSMFPRM of 
the master scheduler’s resident data area (IEEBASEA). 
The master scheduler RIM obtains storage from subpool 
241 for the scheduler NIP parameter list (|EEZB807) and 
stores its address in MSSCHED of the master scheduler 
resident data area (IEEBASEA). 


IEAVNP13. SMFPROC 


2 During master scheduler initialization, the subsystems 
specified in the IEFSSNxx members of SYS1.PARMLIB 
will be initialized. The installation uses the SSN system 
parameter to specify the suffixes for the IEFSSNxx 
members. The master scheduler RIM obtains the address 
of the suffix values from field SSN of PARMTAB and 
stores these values in SNPSSN. The suffix value is in the 
form ‘xnnnn...’, where x is the number of PARMLIB 
members andnnnn ...are 2character suffixes. The RIM 
stores the address of SNPSSN in the scheduler NIP param- 
eter list. If the installation does not specify the SSN param- 
eter, the RIM tries to locate the default member |EFSSNOQ. 
If the default exists, only the suffix ‘QO’ is stored. If the 
RIM cannot locate the default, it continues processing. 


3 Master scheduler initialization will process automatic SYNTXCHK 
commands contained in |IEACMDOO and COMMNDxx 
members of SYS1.PARMLIB (see Step 18 of Diagram 63, 
‘Master Scheduler Initialization’). NIP always uses 
member IEACMDOO. Using the CMD system parameter, 
the installation can specify the suffixes for the 
COMMNDxx members of SYS1.PARMLIB that contain 
the au tomatic commands. The master scheduler RIM 
obtains the suffix values from field CMD of PARMTAB, 
then locates and reads the specified COMMNDxx members. 
If the installation does not specify the CMD parameter, the 


Cr 


Extended Description Module Label 


RIM uses the default member COMMNDOO. If the installa- 
tion does not supply a COMMNDOO member, the RIM 

uses only the automatic commands contained in IEACMDOO. 
The RIM builds a queue of the commands contained in 
IEACMDOO and each COMMNDxx member. Each command 
element in the queue contains a pointer to the next command 
in the queue, the length of the current command, and the 
commands itself in the form the operator would enter it 
from the console. 


READCMPS 


4 The master scheduler RIM loads the subsystem inter- 
face routine, IEFJSREQ, stores its address in the 
JESCT, and then deletes the routine. 
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Diagram 57. Master Scheduler RIM (IEAVNP13) Part 3 of 4 


Input Process 





NVT 


NVTPTAB 






PARMTAB 


LOGCLS 


LOGLMT= 
MSTRJCL= 




















5 Build the command 


address space table 
(CAST). 


Load the scheduled 
commands table. 


Store JES output class 
for the system log data 
sets. 


Store maximum number 
of messages for a log 
data set. 


Store the suffix for 
the master JCL member. 





[IEAVNIPM 





Output 


CVT 
CVTMSER 


CVT 
CVTMSER 


Scheduled commands 
table 


MSRDA (BASEA) 


BACASTPT 


MSRDA (BASEA) 


BASCTPTR 


Log output class 
(MSLOGCLS) 


Maximum number of log 
messages (MSLOGLMT) 
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Diagram 57. Master Scheduler RIM (IEAVNP13) Part 4 of 4 


Extended Description Module L abe! 

5 The master scheduler R|M gets storage for the command BLDCAST 
address space table (CAST) in common storage and 

initializes it. 


6 The RIM loads the scheduled commands table (module 
|IEEMB884) into common storage and stores its address 
in BASEA. 


7 Using the LOGCLS system parameter, the installation LOGRTN 
can specify the JES output class for the system log data 

sets. Master scheduler initialization uses the LOGCLS value 

later during system initialization when it initializes the 

system log, The master scheduler RIM obtains the LOGCLS 

value from PARMTAB, validity checks the value, then places 

it in field MSLOGCLS of the master scheduler resident data 

area {LEEBASEA), 


8 = sCiThe installation uses the LOGLMT system parameter to 
specify the maximum number of messages to be written 
to the log data set. Master scheduler initialization uses 
the LOGLMT value when it initializes the system log. The 
master scheduler RIM obtains the LOGLMT value from 
PARMTAB, validity checks the value, then places it in field 
MSLOGLMT of the master scheduler resident data area 
(1EEBASEA). 


Q The master scheduler RIM uses the MSTRJCL system 

parameter to complete the name of the MSTJCLxx 
member located in SYS1.LINKLIB. The MSTRJCL param- 
eter allows the installation to specify the suffix value for 
the MSTJCLxx member that the master scheduler RIM uses 
to start the master scheduler address space. 


The master scheduler RIM obtains the suffix value from 
the PARMTAB parameter list (field MSTRJCL) and stores 
it in SNPMJCL in the scheduler NIP parameter list. If the 
installation does not specify a suffix, the RJM uses the de- 
fault member, MSTJCLOO. 


The master scheduler RIM issuesa LOAD macro instruction 
for the specified MSTJCLxx member to determine that it 
exists. If the RIM cannot find the member, it prompts the 
Operator to respecify a new value, and this procedure will 
repeat until the specified member can be found or the 
Operator enters an end-of-block (EOB). If an EOB occurs, 
the RIM uses MSTJCLOO. If the RIM cannot find 
MSTJCLOO, it prompts the operator to respecify. This 
procedure repeats until the operator issues an end-of-block. 
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Diagram 58. Generalized Trace Facility Initialization (IEAWVNP17) Part t of 2 


FEAVNIPM 


(Step 36) 
Process 








Initialize the generalized 
trace facility's interface 
for monitor call processing 


Output 











eeeeeeeeee—eee 
AHLMCER 
(MCHMCER) 


¢ FRR 
(MCHERRAD) 





Locate the MC routing 
module and its 
functional recovery 
routine. 


CVTQCDSR 


IEAQCDSR 


CDE search 


or 


CVTLPDSR 


IEAVVMSR 


LPDE search 


(MCHSETE) 
t 


AHLSETD 
(MCHSETD) 


: 


pt 
*¢ AHLREADR 
(MCHREADER) 


AHLRDRTM 
(MCHRDRTM) 
——————————— 


Locate the MC 
SETEVENT modules. 





Locate the cross-address- 
space-read module. 


TFEAVNIPM 
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Diagram 58. Generalized Trace Facility Initialization (IEAVNP17) Part 2 of 2 


Extended Description Module Label 


The generalized trace facility (GTF) traces system and 
problem program events. A monitor call (MC) instruction 
causes an interruption to notify GTF to trace an event. There- 
fore, GTF sets up an interface with monitor call processing. 


1 Before tracing an event, GTF passes control to the MC 
routing module (AHLMCER); the routing module checks 

the SETEVENT tables to determine whether the event is 

one that GTF has selected for tracing. The GTF RIM 

locates AHLMCER and its functional recovery routine in 

order to save their addresses in the monitor call table head 

(MCHEAD). First, the RIM passes control to the nucleus- 


IEAVNP17 LEAVNP17 


resident CDE search routine (IEAQCDSR). |EAQCDSR IEAQCDSR 
searches the CDE chain to determine whether AHLMCER 

is in the fixed link pack area or its modifications. If not, 

the RIM passes control to the nucleus-resident LPA direc- 

tory search routine (IEAVVMSR). IEAVVMSR searches IEAVVMSR 


the LPDEs to determine whether AHLMCER is in the 
pageable link pack area. When either search routine finds 
AHLMCER, the RIM uses the indicated CDE or LPDE 
to locate the doubleword at the beginning of AHLMCER. 
This doubleword contains the entry point address of 
AHLMCER and its FRR. The RIM moves the addresses 
into fields MCHMCER and MCHFRRAD of MCHEAD. If 
neither search routine finds AHLMCER, the RIM issues a 
message to warn the operator that monitor call routing is 
inactive and restores MCHEAD to tts original values. The 
original MCHEAD values are addresses of code that sets a 
return code indicating that MC routing is inactive. 


IEAVNP17 |EAVNP17 


ERROR 


Extended Description Module Label 


2 During processing, GTF issues the SETEVENT macro 

instruction to specify the events it will trace. Two MC 
SETEVENT modules (AHLSETEV and AHLSETD) build 
and manipulate MC tables that indicate the selected 
events. Using the two nucleus-resident search routines 
described in the preceding paragraph, the GTF RIM 
locates the MC SETEVENT modules and places their 
addresses into fields MCHSETE and MCHSETD of 
MCHEAD. If the search routines cannot find both 
modules, the GTF RIM issues a message to warn the 
operator that MC routing is inactive, and restores 
MCHEAD to its original values. The original MCHEAD 
values are addresses of code that sets a return code 
indicating that MC routing is inactive. 


IEAVNP17 


ERROR 


3. + GTF provides a cross-address-space-read function that 
allows ABDUMP, SNAP, and SVC dump to process GTF 

trace buffers. The GTF RIM locates the cross-address- 

space read module (AHLREADR} and places its entry 

point address and error routine address into fields 

MCREADR and MCRDORTM, respectively. 
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Diagram 59. Scheduler Interface to the General Parmlib Scan Routine (IEAVNP18) Part 1 
of 7 


IEAVNP18 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: Scheduler Interface to the General Parmlib 
Scan Routine 


FUNCTION: 

This module issues LOADs for the statement processor routines 
associated with SCHEDxx, initializes a table (PSCKhSTAB) to 
contain the statement types, statement processor routine 
nanes and statement processor routine addresses, and invokes 
the General Parmlib Scan Routine (IEEMB&&8) to process 
SCHEDxx. 

Upon return from IEEMB888, this module deletes the statement 
processor routines. 


ENTRY POINT: IEAVNP18 

PURPOSE: See Function 

LINKAGE: CALL 

CALLERS: NIP Control/Services Routine (IEAVNIPM) 


INPUT: NVT - NIP Vector Table 


OUTPUT: 
General Parmlib Scan Parameter List (IEEZB819}: 
FIELD LENGTH/MASK DESCRIPTION 
PSCNP 40 General Parmlib Scan 


Parameter List 


PSCNID & Identifier 'PSCN' 
PSCNVERS ] Version number 
PSCNFLGS 1 Flags 
PSCNLIST x'80' Write the SYS1.PARMLIB member 
records to the hardcopy log 
PSCNEO3 x'SO' EOB was entered in response to a 
prompt 
PSCNLEN Z length of parameter list 
PSCNTABL G Pointer to the table of valid 


statement types and corresponding 
statement subfunction routines 


PSCNMEM 6 SYS1.PARMLIB member name 
PSCNSTMT 2 Number of statement types 
PSCNENTY G The address of an area which 


contains the member suffixes 
to be appended to PSCNMEM. 


PSCNUSEP G Pointer to a user parameter area 

PSCNNVTP G Pointer to the NVT 

PSCNRSVI 8 Reserved 

PSCNSTAB Table of statement types and 

statement subfunction routine 
names 

PSCNELMT (} 23 

PSCNTYPE 10 Statement type 

PSCNNAME 8 Statement processor routine name 

PSCNADDR G Statement processor routine 
address 

PSCNFLAG 1 Reserved for use by IEEMB888 


EXIT NORMAL: Return to caller 
EXIT ERROR: Return to caller 


EXTERNAL REFERENCES: 
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Diagram 59. Scheduler Interface to the General Parmlib Scan Routine (IEAVNP18) Part 2 
of 7 
IEAVNP18 - MODULE DESCRIPTION (Continued) 
ROUTINES: 
IEEMB888 - Invoked to process the SYS1.PARMLIB 


member, SCHEDx~x. 


CONTROL BLOCKS: 
ASCB - Address Space Control Block 


CVT - Communication Voctor Table 

EcS - Event Control Block 

IEAPMNIP - NIP mapping for NIPWTO, NIPWTOR and NIPMOUNT 
IEAPPNIP - NIP Parameter Area Mapping 

NVT - Nucleus Initialization Vector Table 

PSA - Prefix Save Area 
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Diagram 59. Scheduler Interface to the General Parmlib Scan Routine (IEAVNP18) Part 3 
of 7 


IEAVNP18 - MODULE OPERATION 





This module does the following: 


1. Issues LOADs for the statement processor routines. 
2. Initializes the table of valid statement types 
(PSCNSTAB) with the following statement types for 
SYS1.PARMLIB member» SCHEDxx. 
- EDT 
~ MT 
~ NORESTART 
- PPT 
- RESTART 

3. Stores the statement processor routine names and 

addresses 1n PSCNSTAB. 

Sets PSCNSTMT to the number of statement types. 

Sets PSCNTABL to the address of PSCNSTAB. 

Initializes PSCNMEM to contain the characters SCHED, 

to which the two character combinations (which are 

specified via SCH=(xx)) are appended to form the 

SYS1.PARMLIB member, SCHEDxx. 

7. Initializes PSCNENTY to tne address of a word which 
points to an area containing suffix values for SCHEDxx. 

8. Initializes the version number and identifier. 

9. Stores the NVT pointer into PSCNNVTP. 

10. If the SYS1.PARMLIB member 1s to be written to the 
hardcopy log, then sets bit PSCNLIST sithin I£EZB819 to 
indicate this. 

11. Issues a LOAD for IEEMB888. 

12. Invokes IEEMB&8&8 to process the SCHEDxx SYS1.PARMLIB 


au 





members. \ 
13. If invalid suffix values were specified then 
IEAVNP18 issues prompt IEA906A to obtain valid 
SYS1.PARMLIB specifications. 
IEAVNP18 then invokes IEEMB888 with a parameter 
list and an initialized table of data. 
IEAVNP18 will invoke IEEMB888 until valid specifications 
are received. 
14. If EOB is entered in response to the prompt, sets bit 
PSCNEOB within IEEZB819. 
This will inform IEEMB888 to perform end-of-processing 
(EOP) functions. 
15. Issues DELETEs for the statement processor routines. 
16. Issues a DELETE for IEEMB8&S. 
17. Returns to the caller. 


RECOVERY OPERATION: 

The processing in this module is done during Nucleus 
Initialization (NIP) time and SVC functions are not yet 
available. Therefore, an ESTAE environment has no effect 
at this time. 
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ITEAVNP18 - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAVNP18 


MESSAGES: 


IEA906A RESPECIFY prm PARM OR ENTER EOB 


This message appears when a NIP PROMPT is issued. IEAVNP18 
issues this message when invalid suffix values are specified 
in response to SPECIFY SYSTEM PARAMETERS (for member SCH}. 


The parameter "prim" is "SCH" which is specified in response 
to SPECIFIY SYSTEM PARAMETERS for the SCHEDxx SYS1.PARMLIB 


member. 


ABEND CODES: 


None 


WAIT STATE CODES: None 


RETURN CODES: 


EXIT NORMAL: 


Register 15 = 


EXIT ERROR: 


Register 15 


REGISTER CONTENTS ON ENTRY: 


Register 0 
Register 1 
Register 2 
Register 3 


Registers 4- 
Register 13 
Register 14 
Register 15 


12 


Unde fined 

N/A 

Address of the NIP Vector Table (NVT) 
Address of the Communications Vector 
Table (CVT) 

Undefined 

Address of 18-word save area 

Return address 

Entry point address 


REGISTER CONTENTS ON EXIT: 


Register 
Register 


Registers 
Register 
Register 
Register 


0 
1 


2-12 
13 
14 
15 


Restored 

Address of a word which contains the 
address of IEEZB821 

Restored 

Address of 18-word save area 

Return address s 
Return code 
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IEAVNP18 = Scheduler Interface to the General Parmlib Scan Routine 


NIP Control/Services Routine 
(IEAVNIPM ) 


> 
/ 
IEAVNP18 
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STEP Ol 


This module issues LOADs for the statement 
processor routines associated with 
SCHEDxx, initializes a table (PSCNSTAB) to 
contain the statement types, statement 
processor routine names and statement 


processor routine addresses, and invokes 
the General Parmlib Scan Routine 


(IEEMB888) to process SCHEDxx. Upon return 
from IEEMB888, this module deletes the 
statement processor routines. 





Loads IEEMB888 and saves its 


address. 
oz 


Initializes the General 
Parmlib Scan Parameter List 
see 


\r-cv INITPARM: 12 


Loads the statement 
processor routines 
sre 


\e—7/ LOAD_STMTRTNS: 09 


\IEEZB819 


/ 
PSCNENTY 


















Calls the General Parmlib 
Scan Routine to process the 
SYS1.PARMLIB member, 
SCHEDxx. 
sSN 
\r—7/ IEEMB888 


PSCNP, RETCODE(RCODE ) 


Determines if valid 
specifications were 
encountered: 


A. If invalid specifications are specified, 
then issues a prompt for valid 
SYS1.PARMLIB specifications and calls 
IEEMB888 with the new SYS1,PARMLIB 
specifications. IEAVNP18 continues to 
call IEEMB@88 until valid specifications 
are received. 


B. Otherwise, processing is complete. 


Deletes the statement 
processor routines. 


7 
\r7Z DELETE_STMTRTNS: 19 
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IEAVNP18 =- Scheduler Interface to the General Parmlib Scan Routine STEP 07 


Deletes IEEMB&&&. 


Returns to the caller 









Loads the statemant 
processor routines and 
stores their eddresses in 
the General Parmlib Scan 
Parameter List (IEEZE81iS9). 





LOAD_STMTRTNS 


TEEZE819 \ 
/ 
PSCNNAME 















\IEEZB819 


/ 
PSCNADDR 


Stores the statement 
processor routine addresses 
into PSCNADDR 







Returns to subroutine caller 




















\ 
12 > Initializes the table of 
/ valid statement types and 
INITPARM the General Parmlib Scan 
Parameter List (IEEZB819). 
IEEZB819 \ Initializes the table with \IEEZB819 
/ the valid statement types. / 
[pscnp = PSCNP 
PSCNTABL 
PSCNTYPE 
PSCNNAME 
PSCNFLAG 
IEEZB819 py > 114 | Initializes the General \IEEZB819 
\ Parmlib Scan Parameter List / 
IEEZB819 






[a5 Returns to the subroutine 


PSCNCVER PSCNCID caller 
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IEAVNP18 = Scheduler Interface to the General Parmlib Scan Routine STEP 16 
\IEEZB819 
/ 


'16| Initializes IEEZB819 with 
the proper values. 


Checks NIPPTLST( a bit set \IEEZB819 
by NIP) to determine whether / 
each SCHEDxx SYS1.PARMLIB 
record should be written to 
the hardcopy log. 


ee pl to the subroutine 


caller 


NIPCHECK 












\ 
19 > 19] Deletes the statement 
/ processor routines 
DELETE_STMTRTNS 
IEEZB819 \ 
/ 


PSCNNAME ; 
Returns to subroutine caller 
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DESCRIPTIVE NAME: General Parmlib Scan Routine 


FUNCTION: 

This module scans specified SYS1.PARMLIB member(s) 

for valid statement types, and invokes the proper 
statement processor routine to process these statement 
types. 

This module may be invoked to process one or more of the 
same SYS1.PARMLIB members (e.g. SCHEDxx, CLOCKxx, etc. ). 


ENTRY POINT: IEEMB8&8&8& 
PURPOSE: See Function 
LINKAGE: CALL 
CALLERS: 
IEAVNP18 - Scheduler Interface to the General Parmlib 
Scan Routine 


IEAVNP20 - CLOCK processing RIM 
IEAVNP25 - Nucleus SVC table RIM 


INPUT: 
General Parmlib Scan Parameter List (IEEZB819) 
FIELD LENGTH/MASK DESCRIPTION 
PSCNP 40 General parmlib scan 


parameter list 


PSCNID 4 Identifier 'PSCN’' 
PSCNVERS 1 Version number 
PSCNFLGS 1 Flags 
PSCNLIST x'80' Write the SYS1.PARMLIB member 
records to the hardcopy log 
PSCNEOB X'40' EOB is entered in response to a 
prompt 
PSCNLEN 2 Length of parameter list 
PSCNTABL 4 Pointer to the table of valid 
statement types and the 
corresponding statement processor 
routine names 
PSCNMEM 6 SYS1.PARMLIB member name 
PSCNSTMT 2 Number of statement types 
PSCNENTY 4 The address of an area which 
contains the member name suffixes 
to be appended to PSCNMEM. 
PSCNUSEP 4 Pointer to a user parameter area 
PSCNNVTP 4 Pointer to the NVT 
PSCNRSV1 8 Reserved 
PSCNSTAB Table of valid statement types and 
PSCNE LMT ( % ) 23 statement processor routine names 
PSCNTYPE 10 Valid statement type 
PSCNNAME 8 Valid statement processor routine 
name 
PSCNADDR 4 Address of a statement 
processor routine 
PSCNFLAG 1 Reserved 
OUTPUT : 
Statement Processor Parameter List (IEEZB821) 
FIELD LENGTH/MASK DESCRIPTION 
STMTP 36 Statement processor parameter 
list 
STMTID G Identifier 'STMT' 
STMTVERS 1 Version number 
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IEEMB888 - MODULE DESCRIPTION (Continued) 


STMT FLAG 1 Control Flags 
STMTENT x'80' STMT type entry 
STMTEOP x'S0' EOP type entry 
STMTERR x'20° An error has occurred while 
processing a SYS1.PARMLIB 
membor 
STMTLEN 2 Length of parameter list 
STMTSUFX 2 Suffix value of the SYS1.PARMLIB 


member being processed 


STMTRECL 2 Length of STMT (logical) record 

STMTRECD q Address of a complete logical 
record 

STMTUSEP 4 Pointer to a user parameter area 

STMTNUMB 4 Physical record number of the 
record containing the statement 
type within the specified 
SYS1.PARMLIB member 

STMTNVTP 4 Pointer to the NVT 

STMTRSV1 8 Reserved 


EXIT NORMAL: Return to caller 
EXIT ERROR: Return to caller 
EXTERNAL REFERENCES: 
ROUTINES: 
IEAVM200 - routine containing the message texts for 
messages IEE180I, IEE181I, and IEE182I. 
IEEM8878 - routine which reads SYS1.PARMLIB records 


Statement processor routine names and addresses passed 
as input by the caller. 


CONTROL BLOCKS: 


CVT - Communications Vector Table 
JESCT - Job Entry Subsystem Communication Table 
TABLES: 


PSCNSTAB - A table of valid statement types and statement 
processor routine names is passed by the caller 
as input. A pointer to that table is specified 
in the input parameter list (PSCNTABL). 


5-438 MVS/XA System Init Logic LY28-1200-4 © Copyright IBM Corp. 1982, 1987 











“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Diagram 60 General Parmlib Scan Routine (IEEMB888) Part 3 of 19 
IEEMB888 - MODULE OPERATION 


IEEMB888 does the following: 


1. Validates the input parameter list (1.e., acronym, the 
parameter list length, and the addresses must be non- 
zero). 


- If an invalid parameter list is detected, a return 
code of eight is returned to the caller of IEEMB888. 


2. Examines the area containing the SYS1.PARMLIB 
specifications to determine if any members were 
specified. 


If no members were specified, or if end-of-block was 
specified in response to SPECIFY SYSTEM PARAMETERS then 
does the following: 


A. Invokes the statement processor routines specified 
with an EOP (end-of-processing) type entry. This 
will set defaults for the valid statement types. 


3. Otherwise, SYS1.PARMLIB members were specified and the 
following are processed: 


A. Validates the SYS1.PARMLIB specification(s). 

Each SYS1.PARMLIB specification must consist of a 
two character alphanumeric combination. 

If invalid specifications are encountered, sets a 
return code of four and returns to the caller. The 
return ccde of four informs the caller to issue a 
prompt for valid SYS1.PARMLIB specifications. 

B. Left justifies the SYS1.PARMLIB prefix value and 
stores it into IEEMB878's parameter list (PLIBBASE). 

C. Invokes IEEMB&78 to read a physical record from the 
specified SYS1.PARMLIB member. 

D. If a specified SYS1.PARMLIB member is not found, 
IEEMB878 issues a message indicating that the 
member is not found. 

E. If an I/O error occurs, IEEM38878 issues a message 
indicating this fact. 

F. For each physical record read, does the following: 


1. Removes any comments encountered. 

2. If the caller requests that each record of the 
SYS1.PARMLIB member should be written to the 
operator then, issues a WTO for that record. 


G. For each logical record (collection of all the 
operands for a particular statement type) does 

the following: 

1. If an unbalanced comment is detected, ignores 
data specified between the previous statement 
type and the next valid statement type. Issues 
message IEE181I indicating the unbalanced 
comment cendition. 

- If a statement type has not been encountered 
before the unbalanced comment condition is 
detected, the data from the first physical 
record of the SYS1.PARMLIB member until the 
next valid statement type is ignored. 

2. Validates the statement type by searching the 
table of statement types and statement processor 
routine names that is passed by the caller. 

- If the statement type is not found in the 
table, checks if this is the first statement 
type encountered. 

- If it is the first statement type, issues 
message IEE180I to indicate an invalid 
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IEEMB888 - MODULE OPERATION (Continued) 





statement type. 

If it is not the first statement type, 
stores the data as operands and passes it 
to the statement processor routines when 
another valid statement type is 

detected or end-of-file is reached. 

- Otherwise, deletes the statement type from 
the record and shifts the physical record to 
remove any leading blanks or commas. 

3. Determines if operands are specified on the 
physical record containing the statement type. 

- If no operands are encountered, invokes 
the appropriate statement processor 
routine, passing to it a logical record 
length of zero. 

- If operands are specified, checks the 4K 
buffer to determine if enough room exists for 
this physical record. If there 1s enough 
space, moves the record into the buffer, 
and continues processing the logical record. 
Otherwise, issues message IEE182I 
indicating that the buffer is full. 

ITEEMB888 then processes the next SYS1.PARMLIB 
member, if any exist. 
G4. Invokes the statement processor routine 
associated with the specified statement type. 
5. Blanks out the buffer so it may be used again 
to collect logical records. 
6. nen an end-of-file 1s reached, does the 
following: 

- If more SYS1.PARMLIB members are to be read, 
sets up to read the next one. 

- Otherwise, invokes all of the statement 
processor routings for EOP processing. 

H. Returns to the caller 


RECOVERY OPERATION: 

Tke processing in this module is done during Nucleus 
Initialization (NIP) time and SVC functions are not yet 
available. Therefore, an ESTAE environment has no effect. 
Diagnostic messages are issued for syntax or I/O errors. 
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IEEMB888 - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEEMBS88 


MESSAGES: 
IEE180I mem LINE xo: stmt STMT IGNORED. NOT VALID. 


Results when an invalid statement type is encountered in the 
SYS1.PARMLIB member specified in the input parameter list. 
Processing continues, although defaults may be set for 

those statement types which were not detected in the 
specified SYS1,PARMLIB member(s). 


IEE181I mem: LINE xxxx-xxxx IGNORED. UNBALANCED COMMENT 
DETECTED. 


Results when a starting comment is found without a matching 
ending comment or an ending comment is found without a 
starting comment. IEEMB888 searches for the next valid 
statement type and flags the physical records in error. 

The data located between the previous valid statement type 
and the next valid statement type is ignored. 


IEE182I mem IGNORED. STMT STARTING LINE xxxx EXCEEDS 4096 
CHARS. 


If the buffer containing the logical record to be passed to 
the statement processor routine exceeds 4096 characters, 
this message is issued. The next SYS1.PARMLIB member is 
processed, if any exist. 


ABEND CODES: None 
WAIT STATE CODES: None 


RETURN CODES: 


EXIT NORMAL: 
Register 15 = D = Request completed successfully 
= 4 - Invalid SYS1.PARMLIB specifications 
= 8 - Invalid parameter list 
= 20 - Error occurred in a statement 


processor routine 


REGISTER CONTENTS ON ENTRY: 


Undefined 

Address of a word which contains 
the address of the input 
parameter list. 

Undefined 

Address of 18-word save area 
Return address 

Entry point address 


Register D 
Register 1 


Registers 2-12 
Register 13 
Register 14 
Register 15 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 


Register 0 = Restored 
Register i = Address of a word which contains the 
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IEEMB888& - DIAGNOSTIC AIDS (Continued) 





address of IEEZB821 

Res tored 

Address of 18-word save area 
Return address 

Return code 


Registers 2-12 
Register 13 
Register 14 
Register 15 


EXIT ERROR: 


See EXIT - NORMAL 
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TEEMB888 - General Parmlib Scan Routine STEP O01 


ITEAVNP18 - Scheduler Interface 
to the General Parmlib Scan 
Routine IEAVNP20 - CLOCK 
processing RIM IEAVNP25 - 
Nucleus SVC table RIM 











This module scans specified SYS1.PARMLIB 
member(s) for valid statement types, and 
invokes the proper statement processor 

routine to process these statement types. 


\ This module may be invoked to process one 
>| }|or more of the same SYS1.PARMLIB members 
/ (e.g. SCHEDxx, CLOCKxx, etc. ). 
TEEMBS88 


PARAMETERS 





O1. Validates the caller's input 
parameter list, IEEZB819. 

7A 

\r—17 VALDTE_PARM: 05 


02 IF no SYS1.PARMLIB members 
were specified, or 
end-of-block was specified 
in response to SPECIFY 
SYSTEM PARAMETERS, does the 
following: 


A. Invokes the statement processor routines 
for EOP type processing. 
jeer 
\c—7 EOPRTN: 07 


B. If an error has occurred sets a return 
code of twenty indicating a severe 
error. 


fe Otherwise, SYS1.PARMLIB 
members were specified: 


A. Validates the SYS1.PARMLIB 
specifications. 
sy 
\r—7Z SYNTXCHK: 22 


B. Loads the parser routine. 


LOAD 
EP( TEEMB887 ) 


C. Stores the address of the parser into 
the JESCT. 









D. Loads the message service routine. 


LOAD 
EP( TEAVM200 ) 
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IEEMB888 - General Parmlib Scan Routine STEP O3E 


. Reads and processes the SYS].PARMLIB 
members specified. 


ssf 
\r-—_i7Z7 READMEM: 26 


Returns to the caller. 









\ 
05 > 05 Validates the information 
/ contained in the input 
VALDTE_PARM parameter list, IEEZB819. 
PARAMETERS Sl > 







(06| If an invalid field is 
detected in the parameter 
list, indicates that. 





07 > Invokes each statement 
/ processor routine for EOP 
EOPRTN type processing. 
Sets up IEEZB821 for EOP 
processing. 


f_oy 
\—7 EOPINIT: 12 


Indicates which statement 
Processor routine is given 
control. 


Indicates which statement 
processor routine returned 
control to IEEMB8&8&. 


Returns to subroutine 
caller. 


LE | 
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IEEMB888 - General Parmlib Scan Routine STEP 12 


12 > Initializes the statement 
/ processor parameter list 
EOPINIT (ITEEZB821) for EOP type 
processing. 





Clears out the parameter 
list. 


Initializes the identifier 
with 'STMT‘. 


Initializes the version 
number. 


Initializes the length of 
the parameter list. 


Stores the NVT pointer. 


Stores the pointer to the 
user parameter area. 


Initializes the STMTEOP bit. 


If an error occurred while 
processing a SYS1.PARMLIB 
member, indicates that. 


is] [3] fe] [S) fe} Le} ce) Ee] 


Ei 


Returns to subroutine 
caller. 
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IEEMB888 - General Parmlib Scan Routine STEP 22 
\ 
22 > Syntax checks the 
/ SYS1.PARMLIB member suffix 


SYNTXCHK specifications. If this _ 
routine encounters invalid 
Specifications, 1t returns a 


coce cf four to the caller 
cf IEENB&38. This cede 
informs the caller to issue 
a prempt for valid 
SYS1.PARNLIB specifications. 





[23] If more than one member 1S 
specified, does the 
following: 


A. Points past the left parenthesis. 


B. Searches for valid characters, (comma, 
alphanumeric characters or a right 
parenthesis). 


C. If invalid specifications are 
encountered, then issues a return code 
of four to the caller of IEEMB888. 


If only one member is 
specified: 





A. Scans for valid characters (alphanumeric 
or a quote which NIP appends to the last 
character of the SYS1.PARMLIB 
specifications). 


B. If an invalid value is specified, issues 
a return code of four to the caller of 
IEEMB888. 


Returns to subroutine 
caller. 
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IEEMB888 = General Parmlib Scan Routine STEP 26 
\ 
26 > Invoxes IZEM8878 to read 
/ SYS1.PARMLIB records. 
REACMEM 


Loads the parmlib read 
routine. 


Initializes the parmlib read 
routine parameter list 
(IEEZB822). 


Initializes the base portion 
of the message service 
routine parameter list 
(IEAVM101). 


Invokes IEEMB878 to read a 


SYS1.PARNLIB record. 
/lL—iy 


\-/ IEEMB878 
RETCODE( RCODE78 ) 


Fncrements the number of 
physical recerds. 





If a physcial record is 
successfully read then: 


» If (,L) 1s specified for this parmlib 
member and the physical record is 
non-blank, issues a WTO to the 
operator's console with the record just 
read 


. Scans for the start of a comment. 
fey 
\-c/ BEGINCMT: 36 


- Scans for the end of a comment. 
fj 
\r-—7/ ENDCOMNT: 41 


. Processes the physical record. 
fev 
\-c/ PROCESS_RECORD: 46 


[33] When an end-of-file 
condition occurs: 
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IEEMB888 - General Parmlib Scan Routine STEP 33A J 


A. If an unbalanced comment condition is 
detected, then issues message IEE181I to 
indicate this. 
fe 
\ron 7 UNBALCMT_MSG 


B. Determines if any more members exist to 


process. 
J leet 
\r—7 EOFRTN: 70 


If an error other than an 
end-of-file or an I/O error 
during a read occurs, 
determines if more members 
exist to process. 
freed 
\r- 7 EOFRTN: 70 


[35 Returns to subroutine 
caller. 





\ 
36 > scans for a slash asterisk; 
/ the indicator of the start 
BEGINCMT of a comment. 


If the end of a comment is 
detected with no start of a 
comment: 


A. Indicates that an unbalanced comment 


condition is detected. 


38 If a start of a comment is 
detected and a second 


Starting comment is 
encountered, meaning a 
previous statement contained 
a comment which did not end: 


A. Indicates that an unbalanced comment 
condition is detected. 


If a start of a comment is 


encountered with no 
unbalanced comment 
condition: 


A. Indicates that an unbalanced comment 
condition is detected. 
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IEEMB888 =- General Parmlib Scan Routine STEP 40 


60 Returns to subroutine 
caller. 


\ 
41 > Processes ending comments. 





/ 
ENDCOMNT 


If an end of a comment is 
found for a comment which 
spans more than one physical 
record, deletes the comments 
from the beginning of the 
physical record and removes 
excess trailing blanks. 


[43] If an end of a comment is 

found for a comment which 
started on the same physical 
record: 


A. Deletes the comments and removes any 


excess blanks from the physical record. 


If a comment is to be 
continued over another 
physical record: 


A. Indicates that a comment is being 
continued. 


65 Returns to subroutine 
caller. 
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IEEMB888 ~ General Parmlib Scan Routine STEP 46 





46 > Invokes subroutines to 
/ validate the statement type, 
PROCESS_RECORD saves the operands in the 4K 


buffer, and invokes the 
proper statement processor 
routines to process the 
statement types. 





A. Validates the statement type. 
yy 
\r—/ STMTCHEK: 48 


B. If operands are specified, stores them 
in the 4K buffer. 


C. Invokes the statement processor routine 
to process the statement type. 
sey 
\—/ STMTPROC: 59 


D. If an invalid statement type is 
specified on the first statement, then 
issues message IEE180I. 

7 
\—V/ INVALID_STMTMSG 





E. If this is not the first statement, 
stores the data as operands into the 


buffer. 
Jt 


\r—7Z CHECKBUF: 54 


Returns to subroutine 


caller. 
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IEEMB888 - General Parmlib Scan Routine STEP 48 
\ 
48 > Validates the statement 
/ types on the SYS1.PARMLIB 
STMTCHEK records. 





49 | Determines that the 
statement type is valid. 


50! If no operands are specified 


on the previous statement, 
invokes the appropriate 
statement processor routine, 
passing to it a record 
length of zero indicating 
that no operands are 
specified. 


If a previous physical 

record contained an 

unbalanced comment condition 
en: 


. If a valid statement type is previously 


encountered, the physical records 
ranging from that statement until the 
current statement type are ignored. 
However, if a valid statement type has 
not yet been encountered, the data from 
the first physical record in the 
SYS1.PARMLIB until the next valid 
statement is ignored. 


. Clears the 4K buffer of any data 


relating to the statement type in error. 


. Clears the 4K buffer of any previous 


statements that may have been stored. 


[52] If an invalid statement type 


1s encountered, sets a flag 
to indicate that. 


[53] Returns to subroutine 


caller. 


\ 7 
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IEEMB88s8 - General Parmlib Scan Routine STEP 54 
\ 
54 > Determines if enough room 
/ exists for storing the 


CHECKBUF operands in the 4K buffer. 





[55 | Keeps count of the amount of 
Space avallable in the 
buffer. 


If enough room exists in the 
buffer: 


A. Stores the physical record in the 
buffer. If the current statement is 
non-blank and does not contain a 
statement type, then determines if any 
data exists in the buffer already (from 
the previous statement). If the buffer 
contains data, then stores the current 
record in the buffer. However, a blank 
1s used as a delimiter to separate the 
previous data in the buffer with the 
data currently being stored in the 
buffer. Otherwise, stores the physical 
record as is in the buffer. 


B. Points to the next available character 
in the buffer. 





If there is not enough room 
in the buffer: 


A. Issues message IEE182I 


feo 
\re—7 BUF FER_FULLMSG 


B. Invokes EOFRTN to determine if any more 
SYS1.PARMLIB members exist to process. 


se—N 
\ru7 EOFRTN: 70 


58 Returns to subroutine 
caller. 
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IEEMB888 - General Parmlib Scan Routine STEP 59 

\ 
59 > Invoxes the statement 

/ processor routines for STMT 
STMTPROC type processing. 

Sets up IEEZE821 for STMT 
processing 
ve 


\r—7Z ENTINIT: 67 


Indicates which statement 
processor routine 1s to get 
control. 


Invokes the statement 


processor routine. 


y_H 
\r-—7 MODENTRY 
STMTP, RETCODE(RCDESTMT } 


Indicates which statement 
processor routine returned 
control. 


64| If a severe error occurs in 
the statement processor 
routine, indicates that the 
caller of IEEMB888 may 
prompt for new SYS1.PARMLIB 
specifications. 


Blanks cut the buffer. 


Returns to subroutine 
caller. 
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IEEMB888 - General Parmlib Scan Routine STEP 67 





Initializes the statement 
processor parameter list 
(IEEZB821) for STMT type 
processing. 


Initializes the statement 
processor parameter list for 
statement type processing. 


Returns to subroutine 
caller. 


If there are more 
SYS1.PARMLIB members to 
read, control is returned to 
READMEM to obtain them. 
Otherwise, invokes EOPRTN to 
perform EOP processing. 


Increments the number of 
members processed. 





If all the members are 
processed: 


. Invokes the statement processor routines 
to perform EOP type processing. 


7 —“Iy 
\r-—c7 EOPRTN: 07 


. Indicates there are no more members to 
process. 


Deletes the parmlib read routine. 


DELETE 
EP(MB878 ) 


D. Deletes the message service module. 


DELETE 
EP( TEAVM200 ) 


E. Deletes the parser routine. 


DELETE 





EP( TEEMB887 ) 
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IEEMB888 - General Parmlib Scan Routine STEP 73 















If more members exist to 
process, control is returned 
to READMEM for processing. 


Blanks out the buffer. 





Returns to subroutine 
caller. 
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DESCRIPTIVE NAME: PROGRAM PROPERTIES STATEMENT PROCESSOR 


FUNCTION: 

This module processes the PPT statements in SYS1.PARMLIB 
member SCHEDxx. The PPT statements in SYS1.PARMLIB allow 
an installation to specify a list of programs which require 
special attributes. IEFPPT validates each statement, and if 
the statement is correct, IEFPPT creates an entry in the 
Program Properties Table based on attributes specified in the 
PPT statement. The PPT will then consist of the IBM 
supplied entries plus any entries added as a result of 
valid PPT statements specified in SYS1.PARMLIB member 
SCHEDx~x. 


ENTRY POINT: IEFPPT 
PURPOSE: See Function 
LINKAGE: Call 


CALLERS: IEEMB88& 





INPUT : 
Statement Processor Parameter List (IEEZB821) 
FIELD LENGTH/MASK DESCRIPTION 
STMTP 36 Statement processor parameter 
list 
STMTID 4 Identifier ‘STMT' 
STMTVERS 1 Version number 
STMTFLAG 1 Control flags 
STMTENT *x‘80' STMT type entry 
STMTEOP X'40! EOP type entry 
STMTERR *%'20' Error in STMT 
STMTLEN 2 Length of parameter list 
STMTSUFX 2 Suffix value of the SYS1.PARMLIB 
member being processed 
STMTRECL 2 Length of STMT record 
STMTRECD % Address of a complete logical 
record 
STMTUSEP G Pointer to a user parameter area 
STMTNUMB 4 Record number within SCHEDxx 


being processed 

OUTPUT: PPT is created 
EXIT NORMAL: Return to caller 
EXTERNAL REFERENCES: 
ROUTINES: 

IEEMB887 - Routine that parses the PPT statement for 

valid Keywords 

DATA AREAS: 

IEFZB610 - Program Properties Table 

IEEZB821 - Statement Processor Parameter List 


IEEZB815 - Generalized Parser Input 


CONTROL BLOCKS: 


CVT - Communication Vector Table 

IEFJESCT - Job Entry Subsystem Communication Table 
TABLES: ) 
PPT - Program Properties Table 


PARSETAB - Parse descriptions for IEEZB815 
NAMETABL - TRT for valid program name 
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IEFPPT - MODULE DESCRIPTION Continued) 


ANYTABL - TRT to skip over bad data 

LPARTABL - TRT to skip over bad data until ‘(' reached 
RPARTABL - TRT to ekip over bad data until ')' reached 
BLNKTABL - TRT to skip data until ')' reached 
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IEFPPT - MODULE OPERATION 


1. On the first call to IEFPPT, IEFPPT loads a data-only module 

IEFSDPPT, which contains the IBM supplied PPT entries, 

into storage. IEFPPT obtains storage from extended CSA 

to accommodate the default table, a header for the new 

PPT, plus an additional 50 entries. A copy of IEFSDPPT 

will be placed in the storage area obtained. IEFSDPPT 

is then deleted. IEFSDPPT will be used as a base and 
entries will be added based on any PPT statements that 
appear in SCHEDxx. 


2. For each statement entry, IEFPPT calls IEEMB887 to parse the 
PPT statement for valid Keywords. If the PPT statement 
is valid, those attributes specified are set in the next 
available entry in the PPT. If PPT statement is not valid, 
the statement is ignored and not added to the PPT. 


3. On each subsequent STMT entry, IEFPPT determines if the 
program name specified is a duplicate of what was supplied in 
the IBM default PPT. If so, and if this is the first 
occurrence of a duplicate for the default entry, it overrides 
the IBM supplied entry. PPTDEFLT, in the PPT entry, will 
be set off so that any remaining duplicates for this entry 
will be ignored. If the program name specified on a PPT 
statement has not been specified in any previous entries, 
it is added to the PPT. 


4. IEFPPT will check to make sure there is sufficient space 
in the table. If there is not, IEFPPT issues another 
GETMAIN for the current table size plus an additional 50 
entries. The old table will be copied into the new storage 
area, and the previous storage area freed. The address of 
the new table is placed into the JESCT (JESPPT) anc the PPT 
entry is added to the new table. 


5. At the end of processing (EOP-type call), if no PPT state- 
ments have been specified, IEFPPT will obtain storage from 
extended CSA. IEFPPT loads the IBM supplied default table 
(IEFSDPPT) and copies it into the storage area obtained. 
IEFSDPPT is then deleted. If any valid PPT statements were 
processed before EOP call, IEFPPT will FREEMAIN the message 
area and return to IEEMB8&888. 


RECOVERY OPERATION: 

The processing for this module takes place during 
Nucleus Initialization (NIP) time. Although an ESTAE 
environment could be established at this point, if an 
ABEND did occur, control would not be received because 
RTM is not fully initialized yet. Therefore, an ESTAE 
environment is not established. 
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IEFPPT - DIAGNOSTIC AIDS 


ENTRY POINT NAME: 


IEFPPT 


MESSAGES: 


L.IEF731I mom LINE num:PPT STMT <FOR PGMNAME name> 


IGNORED ./ 
ACCEPTED. REASON=kwrc. 


Where mem is the SCHEDxx SYS1.PARMLIB member which 
contains the bad record, name is the program nama 
specified on the PPT statement in error and num is the 
line number in SCHEDXX where the PPT statement began. 


The PPT statement will be accepted if the keyword that 
is missing a right parenthesis is the last keyword on 
the statement (reason code '40°). In this case, 
“ACCEPTED” will be substituted for "IGNORED" in the 
message text. 


If the program name was not found at the time the error 
was encountered, then the phrase, "FOR PGMNAME name" will 
be suppressed. 


kw denotes the keyword where the error occurred. 
The values for Kw are as follows: 


01 
02 
03 
04 
05 
06 
07 
‘08 
09 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 


- NO KEYWORD CAN BE DETERMINED 

PGMNAME 

KEY 

CANCEL 

NOCANCEL 

- SWAP 

- NOSWAP 

~ PRIV 

- NOPRIV 

- BSI 

~ NODSI 

- SYST 

~- NOSYST 

- PASS 

- NOPASS 

- AFF 

- SPREF 

- LPREF 
NOPREF 


re equals one of the following reason codes: 


04 


08 
12 
16 
20 
24 
28 
32 


36 
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Delimiter between keywords missing or not 
found where expected 


Keyword not valid 

Mutually exclusive Keywords specified 
Parameter not valid 

Duplicate keyword specified 

Keyword list not valid 

Required program name not specified 
Program name not valid 


Duplicate keyword value specified 
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IEFPPT - DIAGNOSTIC AIDS (Continued) 


40 - Missing right parenthesis on last keyword (NOTE - in 
this case, the statement will be accepted) 


2.IEF732I mem LINE ragm:DUPLICATE PPT STMT FOR PGMNAME name 
IGNORED. 


Where mem is the SCHEDxx SYS1.PARMLIB member which 
contains the duplicate PPT statement, name is the 
program name specified on the PPT statement in error and 
num is the line number in SCHEDxx where the PPT statement 
began. 


»LEFO98I mem LINE num:PPT STMT IGNORED. NO OPERANDS SPECI- 
FIED. 


WwW 


Where mem is the SCHEDxx SYS1.PARMLIB member which 
contains the PPT statement with no operands, and 
num is the line number in SCHEDxx where the PPT statement 


began. 


ABEND CODES: None 


WAIT STATE CODES: None 


RETURN CODES: 
EXIT NORMAL: 


0 - Request successfully completed 


REGISTER CONTENTS ON ENTRY: 


REGISTER 0O Unde fined 
REGISTER 1 Address of parameter list 
REGISTERS 2-12 Unde f ined 


Address of savearea 
return address 
Entry point address 


RESISTER 13 
REGISTER 14 
REGISTER 15 


REGISTER CONTENTS ON EXIT: 


EXIT NORMAL: 
REGISTERS 0-14 = Restored 
REGISTER 15 = Return code 
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IEFPPT - PROGRAM PROPERTIES STATEMENT PROCESSOR STEP 01 















IEEMB888 
This module processes the PPT statements 
N in SYS1,PARMLIB member SCHEDxx. The PPT 
>| | statements in SYS1.PARMLIB allow an 
/ installation to specify a list of programs 
PARAMETERS ITEFPPT| |which require special attributes. IEFPPT 
\| [validates each statement, and if the 
STMTP /||statement is correct, IEFPPT creates an 


entry in the Program Properties Table 
based on attributes specified in the PPT 
statement. The PPT will then consist of 
the IBM supplied entries plus any antries 
added as a result of valid PPT statements 
specified in SYS1.PARMLIB member SCHEDxx. 


















If first call to IEFPPT, 
loads IEFSDPPT into storage. 


su HN 
\re—/ GETABLE 


. Gets storage for I3M suppliad tzble, 
IEFSDPPT, plus additional entries, and 
stores entries from IJEFSDPPT into new 


table. 
fey 


\r—/ BUILDTAB: 15 


B. Deletes IBM supplied default table 
TEFSOPPT. 


DELETE 
EP(IEFSDPPT ) 









\PPT 


PPTMSGAD 
02 Determines whether call is 
for STMT or EOP type entry. 


A. If STMT call then processes the PPT 
statement for STMT type entry 


03 If no operands specified on 
the PPT STMT, issues message 
IEFO98I 


seUH SN 


—y[ stawe 
If EOP call after at least 


one STMT call, frees message 
buffer gotten for STMT 
processing. 
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IEFPPT - PROGRAM PROPERTIES STATEMENT PROCESSOR 


5-462 MVS/XA System Init Logic 


If EOP call after at least 


one error message was issued 
then deletes IEFIB650 from 
storage. 


A. Returns to IEEMB888. 


Processes PPT statements and 
invokes generalized parser, 
IEEMB887, to validate 
keywords on each statement. 


Initializes PPT temporary 


entry. 
/ ov 


\—7/ INITIAL 


08, Initializes input parameters 
to IEEMB887. 


soy 
\r-7 SCLINIT 


09, IEEMB887 is invoked to check 
the validity of the PPT 
statements by passing 
control to the appropriate 
exit routines as designated 
by the parse descriptions 
(PARSETAB). After processing 
the PPT statement, IEEMB887 
will return control back to 
this subroutine at the 
instruction following its 
invocation. 


Invokes IEEMB887. 
Loy 


/ 
\r-—7Z 





STEP 05 
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IEFPPT - PROGRAM PROPERTIES STATEMENT PROCESSOR STEP 11 
PPT po--------- > \SCL 
: \ / 
ce 
SCL \PPT 


/ 
PPTEPTR 





PPTHDRLN PPTENTLN 
PPTUSED PPTEPTR 


PPT | > [12] If the program name already 
appears in the PPT 
PPT Sa >| A. If entry in table is an IBM supplied \PPT 


default entry, overrides with new entry / 
B. If entry in table is one specified ina PPTDEFLT 
SYS1.PARMLIB member, SCHEDxx, ignores 


PPT statement and issues message 
IEF 7321. 


sy 


\—/ DUPLMSG 


[12] If no errors or duplicate 
entries were encountered, 
adds the PPT entry in the 
next available entry in the 
PPT. 


PPT po > [13] If no more room in table 


PPTUSED PPTENTS 


A. Obtains storage for new table allowing 
room for current PPT plus fifty 
additional entries. Copies entries from 
old table. 


sy 
\r—1 BUILDTAB: 15 


B. Deletes old table from storage. 


sy 
a 
PPT \ Stores statement in next \PPT 
/ 


/ available entry. 
PPTUSED PPTUSED 
PPTENTRY 
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IEFPPT ~ PROGRAM PROPERTIES STATEMENT PROCESSOR STEP 15 









Obtains storage for the new \PPT 
PPT in extended CSA and / 

PPT copies the entries from the 
Cld table into this table. 


PPTHDR PPTENTRY 
PPTNAME 


PPT 


Obtains storage to 


accommodate fifty additional 


PPTENTS PPTEPTR PPT entries. 
















PPT oy > Saves address of new PPT. 
\ 
, 


PPT 


PPTHDRLN PPTCID 
PPTCVERS 


SAVEPARN 18 Indicates that a closing 
SCL po > right parenthesis was found. 


SCLUSER INPUT: R1 - Address of the SCL R13 - 


Address of Savearea 

OUTPUT: NAMEPARN_FND - Set to ON 
KEYPARN_FND - Set to ON CPUPARN_FND - Set 
to ON 

EXIT: To IEEMB887 


A. Returns to IEEMB887 


SAVENAME 19 Saves the proegram name in \SCL 
SCL ogy > thse PPT temporary entry. / 
\ SCLSTRLN 
SCLUFUNC SCLUSER / 





SCL 


SCLCHAR SCLSTRLN 
oC LSTRNG 
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IEFPPT - PROGRAM PROPERTIES STATEMENT PROCESSOR 


STNCNCL 20) Sets NOCANCEL attribute in 
SCL J ---------- > PPT temporary entry. 
[2a] If NOCANCEL has already been 


specified, issues message 
IEF731I with reason code 
'90520'. 


[22] If CANCEL has already been 
specified, issues message 
TePd3it with reason code 


[23] Otherwise, turns on PPTNCNCL 
bit in the PPT temporary 
entry. 


A. RETURNS TO IEEMB887 


STCNCL 24 Sets CANCEL attribute in PPT 
SCL a > temporary entry. 


If ‘CANCEL’ has already been 


specified, issues message 
IEF731I with reason code 
'0420'. 


If NOCANCEL has already been 
specified, issues message 
yeti with reason code 


Otherwise, turns off 
PPTNCNCL the PPT temporary 
entry 


A. RETURNS TO IEEMB&87 


STEP 20 


\PPT 


PPTNCNCL 


‘ 
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IEFPPT - PROGRAM PROPERTIES STATEMENT PROCESSOR STEP 28 


28 Sets KEY attribute in PPT 
temporary entry. 


If KEY has already been 
specified, issues message 
IEF731I with reason code 
'90320'. 





STKEY 
SCL 2 —  preeeereeen- > 
| 


SCLUSER 







\PPT 


/ 
PPTSKEY 


30 Otherwise, turns on PPTSKEY 
in PPT temporary entry. 


A. RETURNS TO IEEMB8&7 








STKEYNUM Stores KEY value in PPT ——I\SCL 
SCL D ackaaa > temporary entry. / 
\ SCLSTRLN 
SCL 



















SCLCHAR SCLSTRLN 
SCLSTRNG 













PPT \PPT 


/ 
PPTKEY 


NN # 


PPTKEYO PPTKEY1 
PPTKEY2 PPTKEYS3 
PPTKEY@ PPTKEY5 
PPTKEY6 PPTKEY7 
PPTKEY& PPTKEY9 
PPTKEYA PPTKEYB 
PPTKEYC PPTKEYD 
PPTKEYF 


If KEY value is not between 
0 and F, issues message 
IEF731I with reason code 


[32] Assigns the specified value 
to PPTKEY. 


A. RETURNS TO IEEMB887 
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IEFPPT - PROGRAM PROPERTIES STATEMENT PROCESSOR STEP 34 


STNSWAP Sets NOSWAP attribute in PPT 
SCL Sn > temporary entry. 


If NOSWAP has already been 


specified, issues message 
IEF731I with reason code 
'0720'. 


36 If SWAP has already been 
specified, issues message 
IEF731I with reason code 


"0712". 
Otherwise, turns on PPTNSWAP \PPT 
in PPT temporary entry. / 


PPTNSWP 


A. RETURNS TO IEEMB88&7 


STSWAP 38 Sets SWAP attribute in PPT 
SCL Sn > temporary entry. 


39 If SWAP has already been 


specified, issues message 
IEF731I with reason code 
'9620'. 


If NOSWAP has already been 
specified, issues message 
IEF731I with reason code 


"0612". 
Otherwise, turns off PPTNSWP \PPT 
in PPT temporary entry. / 


PPTNSHP 
A. RETURNS TO IEEMB887 
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IEFPPT - PROGRAM PROPERTIES STATEMENT PROCESSOR STEP 42 


STNPRIV 42 Sets NOPRIV attribute in PPT 
SCL Sn > temporary entry. 


If NOPRIV has already been 


specified, issues message 
YEF731I with reason code 
"0920'. 





If PRIV has already been 
specified, issues message 
IEF7312 with reason code 


'9912'., 
Otherwise, turns off PPTPRIV \PPT 
in PPT temporary entry. / 


PPTPRIV 


A. RETURNS TO IEEMB887 


STPRIV 46 Sets PRIV attribute in PPT 
SCL a > temporary entry. 


If PRIV has already been 


specified, issues message 
IEF731I with reason code 
'0820'. 





48 If NOPRIV has already been 
specified, issues message 
IEF731I with reason code 
‘08l2'. 


49 Otherwise, turns on PPTPRIV \PPT 


in PPT temporary entry. / 
PPTPRIV 
A. RETURNS TO IEEMB887 
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IEFPPT - PROGRAM PROPERTIES STATEMENT PROCESSOR STEP 50 


STSYST 50 Sets SYST attribute in PPT 
SCL 5 ie > temporary entry. 
[scuuser | 
aes [51 | If SYST has already been 


specified, issues message 
IEF731I with reason code 
"1220". 


[52 If NOSYST has already been 
specified, issues message 
IEF731I with reason code 


"1212". 
[53] Otherwise, turns PPTSYSTK on \PPT 
in PPT temporary entry. / 


PPTSYSTK 


A. RETURNS TO IEEMB8&8&7 


STNSYST 54 Sets NOSYST attribute in PPT 
SCL Se > temporary entry. 
If NOSYST has already been 


specified, issues message 
IEF731I with reason code 
"1320". 


56 If SYST has already been 
specified, issues message 
IEF731I with reason code 


'1312'. 
otherwise: turns off \PPT 
YSTK in T temporary / 


A. RETURNS TO IEEMB&S87 
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IEFPPT - PROGRAM PROPERTIES STATEMENT PROCESSOR STEP 58 


STDSI 58 Sets DSI attribute in PPT 
SCL 5 een > temporary entry. 


59 If DSI has already been 


specified, issues message 
TEP ait with reason code 





60, If NODSI has already been 
specified, 1ssues message 
itt with reason coda 


61, Otherwise, turns PPTNDSI off \PPT 
in PPT temporary entry. / 


PPTNDSI 
A. RETURNS TO ITEEMB887 


STNDSI 62 Sets NODSI attribute in PPT 
SCL a > temporary entry. 











If NODSI has already been 
specified, issues message 
ter or. with reason code 







If DSI has already been 
specified, issues message 
Teer with reason code 








65, Otherwise turns PPTNDSI on 
in PPT temporary entry. 


\PPT 


/ 
PPTNDSI 


A. RETURNS TO IEEMB887 
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IEFPPT - PROGRAM PROPERTIES STATEMENT PROCESSOR STEP 66 


STPASS 66 Sets PASS attribute in PPT 
SCL en temporary entry. 
If PASS has already been 


specified, issues message 
TEP ett with reason code 


If NOPASS has already been 
specified, issues message 
IEF731I with reason code 


*1412'. 

69) Otherwise, turns off \PPT 
PPTNOPAS in PPT temporary / 
entry. PPTNOPAS 


A. RETURNS TO IEEMB887 


STNPASS||70| Sets NOPASS attribute in PPT 
SCL po > temporary entry. 
SCLUSER 
If NOPASS has already been 


specified, issues message 
IEF731I with reason code 
"1520'. 


If PASS has already been 
specified, issues message 
IEF731I with reason code 
*1512'. 


Otherwise, turns PPTNOPAS on \PPT 
in PPT temporary entry 


. / 
PPTNOPAS 
A. RETURNS TO IEEMB887 
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Diagram 61 Program Properties Statement Processor (IEFPPT) Part 17 of 18 
IEFPPT - PROGRAM PROPERTIES STATEMENT PROCESSOR STEP 74 





Indicates AFF keyword was 


SCL specified in PPT temporary 


entry. 
SCLUSER 


If AFF has already been 
specified, 










. issues message IEF731I with reason code 
‘1620". 






B. RETURNS TO IEEMB887 









Sets CPU Affinity in PPTCPUA 










STCPUNUM \SCL 
SCL Pune > Of PPT temporary entry. / 
3 
SCL \PPT 
/ 





SCLCHAR SCLSTRLN 
SCLSTRNG 


PPTCPUA 


\PPT 
’ 2 
PPTCPUA 





If the CPU number parsed has 
already been specified, 
issues message IEF731I with 
a reason code of 36. If NONE 
and CPU numbers are 
specified together, issues 

IEF731I with reason code 24. 













A. RETURNS TO IEEMB887 


STSPREF||78| Sets SPREF attribute in PPT 
SCL Se > temporary entry. 


If SPREF has already been 


specified, issues message 
yee ett with reason code 


80 Otherwise, sets PPTPUBYT to 
indicate SPREF in PPT 
temporary entry. 





A. RETURNS TO IEEMB8&7 
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Diagram 61 Program Properties Statement Processor (IEFPPT) Part 18 of 18 
IEFPPT - PROGRAM PROPERTIES STATEMENT PROCESSOR STEP 81 














If LPREF has already been 
specified, issues message 
IEF731I with reason code 

'1820'. 


Otherwise, set PPTPUBYT to 
indicate LPREF in PPT 
temporary entry 


\PPT 
/ 
PPTILPU 


A. RETURNS TO IEEMB887 


84 Sets NOPREF attribute in PPT 
SCL temporary entry. 
scwser 85, If NOPREF has already been 


specified, issues message 
IEF731I with reason code 
"1920". 


86. Otherwise, sets PPTPUBYT to \PPT 
indicate NOPREF in PPT / 


temporary entry. PPTN2LP 


A. RETURNS TO IEEMB887 
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Diagram 62 Allocation Load EDT Routine (IEFAB4IE) Part 1 of 7 
IEFABGIE - MODULE DESCRIPTION 


DESCRIPTIVE NAME: Allocation load EDT routine 


FUNCTION: 

IEFABGIE processes the SYS1.PARMLIB EDT statement 
parameter to verify its correctness, and loads the specified 
ELIGIBLE DEVICE TABLE (EDT) member of SYS1.NUCLEUS. 

Any error detected in either loading the table or 
in verifying the parameter causes the parameter to 
be rejected. 


ENTRY POINT: IEFABGIE 
PURPOSE: see Function 
LINKAGE: CALL IEFAS4IE(STMTP ) 
CALLERS: IEEMB888 
INPUT: STMTP - statement processor parameter list 
OUTPUT: 
JESEDT - this field will contain the address at which 
the EDT has been loaded 
EXIT NORMAL: 
EXTERNAL REFERENCES: 
ROUTINES: IGFPTERM 
DATA AREAS: IEASTMTP 
CONTROL BLOCKS: 
IEEZB821 - Statement Processor Parameter List 
CVT - Commumications Vector Table 


IEFZB42]1 - Eligible Device Table 
IEFJESCT - JES Communications Table 


IHAECB - Event Control Block 
IHALRB~ - _LRB Mapping 

IHANVT - NIP Vector Table 
IHAPDS - PDS Directory Entry 
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Diagram 62 Allocation Load EDT Routine (IEFAB4IE) Part 2 of 7 
IEFABGIE - MODULE OPERATION 


This module is called for two reasons: During 
parmlib processing of the SCHEDXX members when an EDT 
statement is found, and at the end of the SCHEDXX 
processing. It will always be invoked at the end of 
processing to ensure that the EDT gets loaded. 


Module internals: 


1) If an EDT is already loaded when this module gets 
control and this is not the end of SCHEDXX 
processing» a message is issued to the operator saying 
that the EDT ID parameter is rejected because it is 
a duplicate specification of the ID. 
Control returns to the caller. 


2) If the EDT hasn't been loaded yet, the EDT ID is 
syntax checked: 
a) For a statement-entry type of invocation , 
the statment must be as follow: 


EDT ID{ <VALUE > 


. Tut is the valid Keyword 

. <VALUE> must be two alphanumeric characters 

. Spaces or commas are permitted between the above 
token 


following rules will be applied : 

- 1f no operands are specified or a Keyword is not 
valid or missing, defaults will be applied at the 
end of statement. 

. if Keyword is specified correctly, but value is 
an error, the default for that keyword is taken 
upon the detection of the errorneous value. 

. if KEYNORD( VALUE ERROR) is specified where: 

VALUE is the correctly specified value and 
ERROR is an incorrectly specified value 
the correct value for that Keyword 1s rejected. 

» Once a valid value (including defaults) has been 
applied for a Keyword, all other occurrences of 
that Keyword are considered as duplicates. 

. statements with an unrecognized Keyword containing 
a contiguous left parenthesis must scanned for an 
ending right parenthesis. When a right parenthesis 
is encountered, the data from the start of the 
unrecognized Keyword until the right parenthesis is 
ignored. 

» if a blank or comma is located after the 
unrecognized Keyword, (before a left parenthesis is 
located), the data from the unrecognized keyword 
until the blank or comma is ignored. 

. the end of a statement, which is passed to the 
statement, is a delimiter. That is, if a right 
parenthesis is not found, the data from the 
unrecognized keyword until the end of the statement 
1S ignored. 


B) For an end-of-processing invocation, if EDT is not 
loaded, default value will be applied 


(default value is obtained from CVTIOCID in the CVT. ) 


3) If a valid ID is obtained, IEFABGIE attempts to load the 
IEFEDTXX member. Note that if a default id is used, 
the operator will be prompted to respecify an EDT ID 
if the member cannot be loaded successfully. 
This processing will be repeated until EDT is loaded. 
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Diagram 62 Allocation Load EDT Routine (IEFAB4IE) Part 3 of 7 
IEFABGIE - MODULE OPERATION (Continued) 





A) A BLDL is issued for the EDT. If the BLDL fails 
a message is sent to the operator and control exits. 


B) An unconditional GETMAIN for ECSA storage is done 
for the EDT. 


C) A LOAD for the EDT is done to bring it in 
at the address of the obtained storage. 
If the load fails control goes to the load error 
routine. 
If the load worked, the EDT address is placed into 
JESEDT. Also a check is made to ensure that the 
EDT is the right version. If it is not, the 
the system is put into a wait state. 
{code 200, reason code 1). 


4) Control returns to the caller. 


LOADERR routine: 
This is the error entry point if the LOAD fails. 
Message IEF338I is issued to the operator. 
The system is put into a wait state (code 200, 
reason code 3). 
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Diagram 62 Allocation Load EDT Routine (IEFAB4IE) Part 4 of 7 
IEFAB4IE - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEFABGIE 


MESSAGES: 
IEF3381 
ISCHEDXX LINE YYYYY: | EDT XXXXXXxXX IGNORED. | UNRECOGNIZED 
| l | KEYWORD. 
[DEFAULT EDT PARAM: | | VALUE NOT VALID. 
| | EXTRANEOUS DATA. 
| IEFEDTXX NOT LOADED. | MEMBER NOT FOUND. 
| DIRECTORY I/O 
| ERROR. 
| BLDL RC 
| XXXX-YYYY. 


| LOAD RETURN XXXx. 
IEF338I SCHEDXX LINE YYYY: DUPLICATE EDT STATEMENT IGNORED. 
IEF338I SCHEDXX LINE YYYY: DUPLICATE EDT ID KEYWORD IGNORED. 
IEF338I SCHEDXX LINE YYYY: MISSING RIGHT PARENTHESIS ON EDT STMT. 
IEF338I SCHEDXX LINE YYYY: DEFAULT EDT ID VALUE XX IS USED. 
IEF338I SCHEDXX LINE YYYY: NO OPERANDS SPECIFIED ON EDT STMT 
IEF339A RESPECIFY EDT CONFIGURATION ID 


IEF927I WRONG LEVEL ELIGIBLE DEVICE TABLE: EDTID DATE TIME 
ABEND CODES: None 


WAIT STATE CODES: 
'200'X, Reason code '003'X 


*200'X, Reason code '001'X 
RETURN CODES: 


zero 


REGISTER CONTENTS ON ENTRY: 


Register 1 - statement processor parameter list 
Register 13 - Address of register save area 
Register 14 - Return address 

Register 15 - Entry point address 


REGISTER CONTENTS ON EXIT: 
register 0-14: restored 


Register 0: unpredictable 

Register 1: address of parameter list for IGFPTERM 
Register 2-14: unpredictable 

Register 15: entry address of IGFPTERM 
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Diagram 62 Allocation Load EDT Routine (IEFAB4IE) Part 5 of 7 


IEFAB4IE - DIAGNOSTIC AIDS (continued) 





Register 0: unpredictable 

Register 1: address of parameter list for IGFPTERM 
Register 2-14: unpredictable 

Register 15: entry address of IGFPTERM 
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Diagram 62 Allocation Load EDT Routine (IEFAB4IE) Part 6 of 7 
IEFABGIE - Allocation load EDT routine STEP Ol 


ITEEMB&888 


\ 


/ 
IEFAB4I 


PARAMETERS 





N7m “™ 


CVT \ 
/ 
CVTIOCID 
IEEZB821l = ----------- > 
J ‘ 
STMTENT / 
STMTEOP 
CVT 






CVTIOCID 


CVTIOCID 


JESCT  ;7---------- > 
_J 


JESEDT 


N 7 





IEFABGIE processes the SYS1.PARMLIB EDT statement 
parameter to verify its correctness, and loads the 
specified ELIGIBLE DEVICE TABLE (EDT) member of 
SYS1.NUCLEUS. Any error detected in either loading 
the table or in verifying the parameter causes the 
parameter to be rejected. 


OL If EDT is not loaded and it is a 


statement-entry type of invocation, 
verify the correctness of the syntax 
of the SYS1.PARMLIB EDT statement 
parameter 


- REPEAT UNTIL END OF RECORD 


» FETCH KEYWORD 


soy 
\r—/ FETKEYWD 


- CHECK SYNTAX OF KEYWORD 


yy 
\p-— CHKKEYWD 


- KEYWORD IS VALID IF VALID KEYWORD FOUND AND IT IS 


THE FIRST ONE 


- FETCH VALUE 


vy 
\r-—/ FETVALUE 


- CHECK SYNTAX OF VALUE 


sry 
\rc—/ CHKVALUE 


» IF VALUE IS INVALID, DEFAULT VALUE WILL BE USED. 


- AT END OF PROCESSING, IF NO VALID KEYWORD IS 


FOUND, USE DEFAULT VALUE 


If EDT is not loaded and it is an 
end-of-processing invocation, use 
the default EDT ID from CVTIOCID in 
CVT. 


Attempt to load the EDT from 
SYS1.NUCLEUS. 


A. IF LOAD FAILS, THE LOADERR ROUTINE WILL GET 


CONTROL. MESSAGE IEF338I WILL BE ISSUED TO THE 
OPERATOR AND THE SYSTEM IS PUT INTO A WAIT STATE. 
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Diagram 62 Allocation Load EDT Routine (QEFAB4IE) Part 7 of 7 
IEFABSIE = Allocation load EDT routine 


EDT B. IF EDT IS LOADED SUCCESSFULLY, FILL IN THE EDT ID, 

: SET THE EDT BASE POINTER AND PUT IT IN JESCT. IF 
THE EDT IS A 370 VERSION OR NOT THE CORRECT LEVEL, 
THEN CALL PROCEDURE SYSWAIT TO PUT THE SYSTEM INTO 
A WAIT STATE AND MESSAGE IEF927 WILL BE ISSUED TO 
THE OPERATOR. 







EDTNAME 
EDTLEVEL 
EDTLITRL 
EDTSP220 


IEEZB821 








04 If EDT is already loaded and it is a 
statement entry type invocation, 
issue message IEF338I SCHEDXX LINE 
YY: DUPLICATE STATEMENT IGNORED. 


CVT LOADERR routine = receive control 

when LOAD was unsuccessful. Set up 
the enviroment to call IGFPTERM to 
put the system into the wait state. 


TEEZB821 


A message will be issued to the 
operator and a LOGREC record will be 
written. LOGIC: build error message 
IEF338I1. 





STMTSUFX 
STMTNUMB 
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STEP 03B 


\JESCT 


/ 


JESEDT 


\EDT 


/ 


EDTID 
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Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 1 of 16 
IEFRCSTP - NODULE DESCRIPTION 


DESCRIPTIVE NAME: Restart Codes Statement Processor 


FUNCTION: 
IEFRCSTP is used to customize the standard IBM 
supplied list of ABEND codes eligible for automatic 
restart. This list of codes is contained in IEFYRCDS, 
a data only module residing in SYS1.LINKLIB. 
IEFRCSTP is invoked by the Generalized Parmlib Scan 
Routine (IEEMB888}. 
Two entry points have been defined within IEFRCSTP: 

- Entry point IEFRCADD is responsible for processing 
RESTART type statements in the SYS1.PARNMLIB member 
SCHEDxx. The RESTART statement enables an installation 
to expand the IBM supplied list of codes from IEFYRCDS 
to include user defined ABEND codes. 

- Entry point IEFRCDEL is responsible for processing 
NORESTART type statements in the SYS1.PARMNLIB mamber 
SCHEDxx. The NORESTART statement enables an 
installation to delete codes from the list of ccdes 
eligible for automatic restart. This list includes 
both the IBM supplied and the user defined codes. 


ENTRY POINT: IEFRCADD 
PURPOSE: See Function 
LINKAGE: CALL 


CALLERS: IEEMB888 


INPUT: 
Statement Processor Parameter List (IEEZB821 ) 
FIELD LENGTH/MASK DESCRIPTION 
STMTP 36 
STMTID bs Identifier 'STMT' 
STHMTVERS 1 Version number 
STMTFLAG 1 Control flags 
STMTENT x'30' STMT type entry 
STMTEOP x'GQ' EOP type entry 
STMTERR x'20' Error in statenent 
processor routine 
STMTLEN 2 Length of parameter 
list 
STMTSUFX 2 Suffix of the 


SYS1.PARMLIB member 
being processed 


STMTRECL 2 Length of STMT record 

STMTRECD 4 Address of a complete 
logical record 

STMTUSEP & Pointer to a user 
parameter area 

STMTNVTP 4 Pointer to the NVT 

STMTNUMB be Record number within 
SCHEDxx being processed 

STMTRSV1 8 Reserved 

OUTPUT: 


Updated version of the table of restart codes 
eligible for automatic restart 


EXIT NORMAL: Return to caller 
EXIT ERROR: None. IEFRCSTP will not return if ABBENDED. 


ENTRY POINT: IEFRCDEL 
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Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 2 of 16 


IEFRCSTP - HMNODULE DESCRIPTION (Continued) 


PURPOSE: See Function 

LINKAGE: CALL 

CALLERS: IEEtHBS88s8& 

INPUT: same as for IEFRCADD 

OUTPUT: same as for IEFRCADD 

EXIT NORMAL: Return to caller 

EXIT ERROR: None. IEFRCSTP will not return if ABBENDED. 
EXTERNAL REFERERMCES: 


ROUTINES: 
IEEMB8B7 - Routine that parses the RESTART/NORESTART 
statement for valid Keyword and abend codas 


DATA AREAS: 
IEFYRCDS - Data only module centaining the IBM supplied 
list of system completion codes eligible for 
automatic restart 


CONTROL BLOCKS: None 


TABLES: 
IEFRSTB - Table of cedes eligible for 
automatic restart 
PARSETAB - Table of parse arguments to be passed to 
the generalized parser (IEEMB&87 ) 
EBCDICX ~ Translate table used to convert EBCDIC to 
internal hex 
HEXTABLE - Translate table used to flag any 
non-hexadecimal character 
ALLTABLE - Translate table used to parse through an 
erroneous string so that all characters 
will pass 
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Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 3 of 16 


IEFRCSTP - MODULE OFERATION 


This module processes RESTART/NORESTART statements 
in the SYS1.PARNLIB member SCHEDxx. It does the 
following: 


1. Cn the first statenent (STMT) entry to IEFRCSTP, 
the IPM supplicd list of system cempletion codzs 
eligible for automatic restart will be lozdcd into 
storage. This list is contained in IEFYRCOS, a 
data only module residing in SYS1.LINXLIB. 

IEFRCSTP will obtain storage fren extended CSA 

to accomodate the default list plus an additional 
50 entrics. A copy of the IDM supnolied list of 
codes eligible for automatic restart will be placed 
in tne storage area obtained and anchored in the 
JESRSTRT field of the JESCT. The IBM supplied list 
will be used as a base and entries will be added or 
deleted, based on any RESTART/NORESTART statements 
that appear in the SYS1.PARMLIB menker SCHEDx~x, 

to form the table of codes eligible for autcmatic 
restart CIEFRSTB). 


2. For each STMT entry, IEFRCSTP calls tine Generalized 
Parse Routine (IEENB887) to parse the statement 
for valid syntax, 
If the statement is valid, the codms specified are 
either deleted from the table of codes eligible for 
automatic restart (IEFRSTB), or addzd to the end of 
the user cdefined portion of the tzble. 
IEFRCSTP will continue prosessing coces until the 
end of the statement or an erroneous code is 
encountered. 
If an invalid cod2 is encountered, IEFRCSTP will 
issue an informational iressage and stop processing 
the statenent. The remainder of the statement 
will be ignored, 


3. On the end of processing (EOP) entry, if no valid 
RESTART/LORESTART statements were specified, 
IEFRCSTP will obtain storage from extended CSA, 
IEFRCSTP will then load the IBM supplied list of 
systen completion codes eligible for automatic 
restart, found in data only mocule IEFYRCDS, 
and cepy it into the storace area cbtained. In this 
case the table of codes eligibla for automatic 
restart (IEFRSTS) will consist only of the IBM 
supplied list of codes eligible for automatic 
restart. 


G. If no operands are specified on the RESTART/ 
NORESTART statement, IEFRCSTP will issue an 
informational message stating that no operands 
were specifed. The statement will be ignored. 


IEFRCSTP is entered at one of two points, IEFRCADD 
or IEFRCDEL. The point of entry is determined by 
the general parmlib scan routine, IEEMB8&3s. 


- When IEEMB&888 invokes IEFRCSTP to process a RESTART 
statement type, control is passed to the RESTART codes 
statenent processing entry point within IEFRCSTP 
(IEFRCADD). The restart statement processing will then 
search through the restart codes table (IEFRSTB) for a 
matching code. If a matching cede is not found, the 
restart codes statement processing will add the valid 
code to the user defined portion of IEFRSTB. 

If a matching code is found, the restart codes statement 
processing will issu2 an informational message stating 
that a duplicate code exists. 
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Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 4 of 16 
IEFRCSTP - MODULE OPERATICN (Continued) 





- When (IEEHB8B3) invokes IEFRCSTP to process a 
NORESTART statement type, control is passed to the 
MORESTART statement processing entry point within 
TEFRCSTP (IEFRCDEL). The NORESTART statement processing 
looks for a riatching code in the table of restart codzs 
(IEFRSTB). If a matching code is found, the code will 
be deleted from the table. If a matching code is not 
found, the NORESTART statement processing will issue an 
informational message stating that tha code was not 
found. 


Diagram of IEFRSTB: 
(the table of eligible restart codes) 


HEADER 


length of IBM supplied | 
portion of the table | 
| 


the standard IBM supplied list of 
system completion cedes eligible 
for automatic restart 





length of user defined | 
portion of the table | 
| 


the list of user defined 
completion codes eligible 
for automatic restart 


RECOVERY OPERATION: 

The processing for this module takes place during 
nucleus initialization (NIP) tims. Although an ESTAE 
environment could be established at this point, if an 
ABEND did occur, control would not be received because 
RT 1s not fully initialized yet, therefore an ESTAE 
environment is not established. 
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Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 9 of 16 


IEFRCSTP - Restart Codes Statement Processor STEP ll 
\ 
11 > Initializes the table of 
/ codes eligible for automatic 
INITTAB restart CIEFRSTB) with the 


I8M supplied defaults. 





[12] Loads IEFYRCDS, the module 
containing the IBM supplied 
default list of codes 
eligible for automatic 
restart, into storage. 


[13] Calculates storage needed to 
hold default teble plus 50 
additional entries. 


[14] Obtains storage for the IBN 
supplied list of restart 
codes plus the additional 50 
entries. 


7c 
\-—7 GETTAB 


Copies the IBN supplied list 
of restart codes from 
IEFYRCDS into the storage 
obtained and anchors the new 
table (IEFRSTB) in the 
JESRSTRT field of the JESCT. 


sin 
\r—7Z FILLTAB 


16 Initializes the header, 
including the pointers used 
to reference the table of 
restart codes (IEFRSTB). 


7L—AN 
\p—7Z7 HDRSETUP 


Deletes IEFYRCDS, the module 
containing the TEI supplied 
default list of codes 
eligible for autonatic 
restart, from storage. 


Returns to the subroutine 


caller. 
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Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 10 of 16 
IEFRCSTP - Restart Codes Statement Processor STEP 19 


KYNRDYES 


Translates the keyword id, 
passed in SCLDATA, from 
Hexadecimal form to EBCDIC 
representation. 


Determines if the keyword 
being processed was 
previously encountered. 


» If no duplicate keywords were 
encountered on the statement, processing 
is continued. Determines which keyword 
1s being processed. 


. Otherwise, a duplicate keyword was 
encountered and message IEF734I is 
issued indicating this situation. 


yoy 


\-—7/ MSGRTN 


Returns to IEENS887 (the 
generalized parser). 


KYWRDNO 23 Unrecognizable data 
encountered routine. 


Determines if the erroneous 
data 1s an unrecognized 
keyword or trailing data 


Sets return code, indicating 
stop the parse. 


26 | Returns to IEENS8&87 (the 
generalized parser). 
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Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 7 of 16 


IEFRCSTP - Restart Codes Statement Processor STEP 01 


‘N IEFRCSTP is used to customize the standard 
>|] IBM supplied list of ABEND codes eligible 
/ for automatic restart. This list of codss 
ITEFRCSTP| }is contained in IEFYRCDOS, a data only 

module residing in SYS1.LINKLIB. IEFRCSTP 
is invoked by the Generalized Parmlib Scan 
Routine (ZIEEMNB&AE8). Two entry points have 
been defined within IEFRCSTP: 
- Entry point IEFRCADD is responsible for 
processing RESTART type statements in the 
SYS1.PARMLIB menber SCHEOxx. The RESTART 
statement enables an installation to 
expand the IBM supplied list of codes from 
IEFYRCDS to include user defined ABEND 
codes. 
- Entry point IEFRCDEL is responsible for 
processing NORESTART type statements in 
the SYSL.PARNLIB member SCHEDxx. The 
NORESTART statement enables an 
installation to delete codes from the list 
of codes eligible for automatic restart. 
This list includes both the IBM supplied 
and the user defined codes. 





TEEMEE838 


\ 

> Entry point for processing 

/ the RESTART staterent tyne 

ITEFRCAD in the SYS1.PARNLIB member 
\ SCHEDXx. 


If the table of restart 


codes (IEFRSTB) has not been 
anchored in the JESCT, dogs 
the following: 


PARAMETERS 





A. Initializes the table of restart codcs 
(IEFRSTB) and anchors it in the JESRSTRT 
field of the JESCT. 


s/—N 
\r—7 INITTAB: 11 


03. [If this invocation is for 
statement (STNT) processing, 
dces the following: 


A. Sets function indicator to ADD, 
indicating RESTART processing 


B. Checks the validity of the input string 


sr—yN 
\ru—72 CHECKREC 


Ocherwise, this invocation 
1s fer end of processing 
(EOP). 
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Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 8 of 16 


IEFRCSTP - Restart Codes Statenent Processor STEP 05 


Returns to IEEMB88&8& 


IEEI!3888 
\ 
> 9) Entry point for processing 
/ the HORESTART statement type 
ITEFRCDEL in the SYS1.PARIMNLIB member 


PARAMETERS \ SCHED XX. 
/ 
STMTP 
[07] If the table of restart 


codes (IEFRSTB) hes not been 
anchored in the JESCT, does 
the following: 


. Initializes the table of restart codes 
{IEFRSTB) and anchors it in the JESRSTRT 
field of the JESCT. 
se 
\-/ INITTAB: 11 


oa! If this invocation is for 
statement (STINT) processing, 
does the following: 


. Sets function indicator to DEL, 
indicating NORESTART processing 


. Checks the validity of the input string 
si—N 


\-—c/ CHECKREC 
Otherwise, this invacation 


is for end of processing 
(EOP). 


Returns to IEENB8&8& 
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P Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 5 of 16 


= IEFRCSTP - DIAGNOSTIC AIDS 


ENTRY POINT NAMES: IEFRCADD 
IEFRCDEL 


MESSAGES: 


TEF/738I mem LINE num: <RESTART,NORESTART> STMT IGNORED. 
NO OPERANDS SPECIFIED. 


IEF734I mem LINE num: <RESTART,NORESTART> <CODE code, 
STATEMENT> <IGNORED,ACCEPTED>. REASON= Kyrc 


Where: 
mem - indicates which SCHEDxx SYS1.PARMLIB member 
contains the bad statement 


num - indicates which line in the SCHEDxx SYS1.PARMLIB 
member 1s being processed 


code - indicates the abend code (specified on the 
statement) in error 


kyrc - represents a Keyword-reason code for the error 
encountered 
ky - Keyword, the numerical representation of the 
keyword being processed (decimal ) 
roe - reason code, the numerical representation of the 
error encountered (decimal ) 


The following are valid Keyword/reason code (kyrc) 


wy combinations: 
ky: O1 - Unexpected data encountered 
re: 08 - Unrecognized keyword 
28 - Keyword list not valid 
44 - End delimiter in a Keymord list (right 
parenthesis) missing 
48 - Data following Keyword list ending delimiter 
(right parenthesis) encountered 
ky: 02 - CODES( 
reo: 16 - Value out of range 
52 - Code already exists 


56 - Code not found 
60 - Duplicate keyword encountered 


ABEND CODES: None 
WAIT STATE CODES: None 


RETURN CODES: 
ENTRY POINT IEFRCADD: 
EXIT NORMAL: 


0 - Request successfully completed 


( ENTRY POINT IEFRCDEL: 


EXIT NORMAL: 
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Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 6 of 16 


IEFRCSTP - DIAGNOSTIC AIDS 


(Continued ) 


O - Request successfully completed 


REGISTER CONTENTS ON ENTRY: 
ENTRY POINT IEFRCADD: 


Undefined 

Address of a word that points to 
@ parameter list 

Undefined 

Address of savearea 

Return address 

Entry point address 


Register 0Q 
Register 1 


Registers 2-12 
Register 13 
Register 14 
Register 15 


ENTRY POINT IEFRCDEL: 


same as for IEFRCADD 


REGISTER CONTENTS ON EXIT: 
ENTRY POINT IEFRCADD: 
EXIT NORMAL: 


Restored 
Return Code 


Registers 0-14 
Register 15 


ENTRY POINT IEFRCDEL: 
EXIT NORMAL: 


same as for IEFRCADD 
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Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 11 of 16 


IEFRCSTP - Restart Codes Statement Processor STEP 27 


CDSYES 27] Valid cade found in input 
string routine 


23 | Determines which parse 
statement passed control to 
this routine and how to 
process the information. 


If a good code was 
encountered by the parser, 
does the following. 


A. Indicates valid code was found 
B. Extracts the code from the input buffer. 


C. Translates the code from EBCDIC into 
internal hexadecimal. 
sy 
\e—/ TRANSLATE 


D. Searches through the table of codes 
eligible for automatic restart for a 


match. 
a)’ 
\re—/ FINDIHATCH: 32 


E. Changes the table of codes eligible for 
automatic restart by either adding or 
deleting the code. 


fs Hvy 
\r 2 CHNGRSTB: 36 


EI 


0) Otherwise this was not a 
valid code. 


Returns to IEEI8887 (The 
generalized parser). 


EI 
j= 
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Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 12 of 16 


IEFRCSTP - Restart Codes Statement Processor STEP 32 
\ 
32 > Checks the table of restart 
/ codes for a code that 


FINDIHWATCH matches the input code. 


If the input code is 
non-zero then, searches 
throuch the IBM supplied 
codes for a match. 





If a matching code was not 
found in the IBM supplied 
codes, then does the 
following: 


A. Searches through the user defined codes 
for a match. 


Returns to the subroutine 


caller 
k / 
\ 


36 > The restart codes table 
Customization Routine 





/ 
CHNGRSTB 


If a match was found in the 
table of eligible restart 
codes, does the following: 


. Lf this invocation is to add a code for 
RESTART processing, issues a message 
indicating that the code already exists. 


soy 


\r—Z MSGRTN 


. Otherwise, this invocation is to delete 
a coda for NORESTART processing» 


- Deletes the existing code from the 
table. 


Otherwise a match was not 


found in the table of 
eligible restart codes, so 
does the following: 


A. If this invocation is to add a code for 
RESTART processing, checks if space is 
available to add an entry 
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Diagram 63 RESTART Codes Statement Processor (TEFRCSTP) Part 13 of 16 


IEFRCSTP ~ Restart Codes Statement Processor STEP 38B 


. If no space in the user defined portion 


of the table, then obtains storage to 
contain the existing copy of the table 
of restart codes plus an additional 50 
entries. 


sr, 
\rnn7 XPANDTBL: 40 


. Adds the code to the table of restart 


codes. 


. Otherwise this invocation is to delete a 


code for NORESTART processing» issues a 
message indicating that the code was not 
found in the table of restart codes. 


se Hh 


\r——7 MSGRTN 


Returns to the subroutine 
caller 


Expands the table of codes 
Cligible for e2utomatic 
restart to hold an 
additional 50 entries 


Calculates the amount of 
storage necessary to contain 
the existing table plus 50 
additional entries. 


Obtains storage for the 
existing table plus the 
additional 50 entries. 


sry 


\-—/ GETTAB 


Copies the existing table 
into the storage obtained, 
and anchors the new table 
(IEFRSTB) in the JESRSTRT 
entry of the JESCT. 


yey 


\—/ FILLTAB 
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Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 14 of 16 
IEFRCSTP - Restart Codes Statement Processor STEP 4G 


Reinitializes the header, 
including pointers used to 
reference the table of 
restart cedes (IEFRSTB). 


7 
\r—7 HDRSETUP 


Frees the storage that held 
the existing version of the 
table of restart codes 
(IEFRSTB). 


yy 
\r— FREETAB 


Returns to the subroutine 
caller. 


RPYES Right parenthesis found 
routine 


Indicates right parenthesis 


was found. 


149] Returns to IEEMNS8887 (The 
generalized parser). 





CDSNO 50 Invalid code found routine 


Issues a message indicating 
that an invalid code was 
encountered. 


7 y 
\e—7 MSGRTN 


. Sets return code, indicating stop the 
parse. 


Returns to IEEN®8387 (The 
generalized parser). 
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Diagram 63 RESTART Codes Statement Processor (IEFRCSTP) Part 15 of 16 
IEFRCSTP - Restart Codes Statement Processor STEP 53 


BADSTR 53 Invalid string found routine 


A. Issues a message indicating that an 
invalid code was encountered. 


vey 
\r-—7 MSGRTN 


. Sets return code, indicating stop the 
parse. 


Returns to IEENB887 (The 
generalized parser). 


ENDRTN End of Statement Processing 
Routine 


If an unrecognizable keyword 
was encountered, issues a 
message indicating that an 
unrecognizable keyword was 
encountered. 


yc 


\r—/ MSGRTN 


Otherwise, a valid keyword 
was found by parser, does 
the following: 


A. If the in-coming Keyword list contains 
at least one error, bypasses checking 
the other indicators. Note: the parse of 
the input string did not finish at the 
end of the input record. Therefore, the 
remaining indicators may produce 
messages that could be misleading 


. If no errors were encountered by the 
parse of the in-coming Keyword list; 
checks the remainding indicators. 


. If no valid codes were found by the 
parser, issues a message indicating that 
the Keyword list is invalid. 


su 


\r—/7 MSGRTN 
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Diagram 63 RESTART Codes Statement Processor (EFRCSTP) Part 16 of 16 
IEFRCSTP - Restart Codes Statement Processor STEP 57D 





. Otherwise, the keyword list contains 
only valid cedes, if the Keyword list 
ending delimiter was not encountered by 
the parser, issues a message indicating 
that the Keyword list ending delimiter 
1S m1Ssing. 


sos 


\—/ MSGRTN 


. Otherwise, a right parenthesis was 
found. If extraneous data was 
encountered after the Keyword list 
ending delimiter, then issues a message 
indicating that extraneous data was 
encountered. 


sos 


\r—/ MSGRTN 
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Diagram 64. MSSC Initialization (IEAVNP19) Part 1 of 2 


Input 


CVT 
el 
CVTUCBA 







UCB 
——SEx S| 
ES 
UCBN 
DCQFIRST . eee 
———————— UCB3UREC=1 


UCBT BYT4=1 


DCQCHAIN 


DCQDEVCL 


Non-DASD 
———— 


DCQVCBAD 
pe ee 


Cc 
Oo 
fe) 





UCBRR 
BNXUCB 
UCB3DACC=1 


Cc Cc Cc 
O i?) O 
wo w 
DVD w 
< a 
oO mi 
m Cc 
< u 


DCQCHAIN 
DCQDEVCL UCB 
DASD | 
DCQUCBAD UCBNXUCB 
. V=0 
@ 


oi 
) 
ow 
ae 
< 
e @ wy) 
m 


DCQELMNT 


UCB 
fa 
aa KeD UCB3DACC=0 
= | UCBRVDEV=0 
a 
———— 








Output 


UCBs 










UCBLPM 

{Logica} path mask) 

——— are ee ee ee 
UCBVOLI 

1 Determine if MSS is in {Volume serial number} 


this system. av aR 


UCBVTOC 
(TTR of VTQC) 

















UCBVHRSN | UCBVORSN |UCBONL! 
(Hierarchy (Qperator (Ontine flag) 
reason flag) | reason flag) 













2 Test sharability and 
availability of virtual 
direct access devices (DASDs). 










UCBNRY UCBNALOC 
(Not ready (System use) 
flag) 


UCBVALPH 
(Path 
verification 
flag) 


a. Verify paths to virtual 
DASDs. 


IEAVNPO2 


EP IEAVNPC2 
Test virtual 
direct access 
devices 







UCBRR 
(Sharable 
flag 1) 







UCBSHRUP 
(Sharable 
flag 2) 





b. Check for duplicate 
volume serial numbers. 


IEAVNIPM 
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Diagram 64. MSSC Initialization (IEAVNP19) Part 2 of 2 


Extended Description Module L abel 


IEAVNIPM calls the mass storage system communicator 
(MSSC) RIM to determine whether the mass storage system 


(MSS) is to be used in this system and, if so, to verify paths 
to the virtual direct access devices (DASDs). 


1 The MSSC RIM scans the unit record device class queue IEAVNP19 
(DCQ) to locate all UCBs associated with mass storage 

controllers (MSCs) (UCBTBYT4=X‘'42’), and take appropriate 

action: 


e If the MSSC RIM finds no MSC UCBs, it performs no 
further initialization and returns control to IEAVNIPM. 
CVTICB remains zero, an indication to other system 
components that MSS is not in this system. 

e If the MSSC RIM finds online MSC UCBs, it sets the 
UCBALOC bits to show that the devices corresponding 
to the UCBs are allocated and continues processing. 


2 The MSSC RIM calls the IOS RIM at entry point 

IEAVNPC2 to test the MSS devices for shareability 
and availability and initialize the UCBs. The |OS RIM uses 
the DCQ to select the UCBs foreach MSS device. The fields 
UCB3DACC and UCBRVDEV indicate whether devices 
are virtual direct access storage devices. 


IEAVNPO2 


a. The lOS RIM calls the service routine IOSVNPTH to 
test the availability of each of these devices. IOSVNPTH 
issues a STARTIO macro instruction along each 
installed online path to determine if the device is 
physically available on that path. 


When a device is marked sharable at SYSGEN 
(UCBRR=1), |OSVNPTH verifies its sharability using a 
RELEASE CCW command. If the device doesn’t have 
this capability, it rejects the RELEASE command. 
IOSVNPTH sets the flags UCBSHRUP=0 and UCBRR=0 
to indicate that the device is not sharable. 


NPTHIO 


If the device was designated as not sharable, 
1OSVNPTH issues an 1/0 NOP CCW command. 


Extended Description 


_ To check for duplicate volume serial numbers for online 


Module Label 


IOSVNPTH times all |/O operations. If an operation 
does not complete within 1.5 seconds, |OSVNPTH 
issues SVC 16 to purge the operation and resets 
UCBLPM to indicate that the device is offline. 


NPTHSTIO 


if any path to the device verifies successfully, 
IOSVNPTH sets the following UCB fields: 


Field initialized Initialization value 


UCBONLI 
UCBLPM 


“1 ‘—device is online 

Indication of which paths are avail- 
able to the device 

‘O'—indicates that a path is verified 
for this device 


UCBVALPH 


If no paths verify successfully, IOSVNPTH marks the 
device offline, sets UCBLPM to the initial state (the 
same value as the path installed mask), and sets fields 
UCBVHRSN and UCBVORSN to indicate why the 
device is offline. 


If, after the above processing, the MSS device is to be 
brought online and a device initialization exit exists 

for the device, then |OSVNPTH issues a sense-id 
command. The device initialization exit then initializes 
any feature fields unique to this device. If the exit fails, 
the device is marked offline. 


DEVINIT 


IEAVNPO2 NP2LDUP 
direct access device, the |OS RIM scans all UCBs. If it 

finds a duplicate serial number, it issues message 

IEA212A to request that the operator demount one 

of the volumes, After the operator responds with the 

device number, the |OS RIM issues the MSSC SVC 


instruction to demount the volume. 


On return from the MSSC SVC, the IOS RIM places 
zeroes in the volume serial number and VTOC fields of 
the UCB for the device that had the volume demounted 
and marks the device not read. 


For additional information, see Mass Storage System 
Ex tensions Logic: MSS Communicator {MSSC). 
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Diagram 65 CLOCK Processing Resource Initialization (IEAVNP20) Part 1 of 11 
IEAVNP20 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: CLOCK Processing Resource Initialization Module 


FUNCTION: 
IEAVNP20 processes SYS1.PARMLIB member CLOCKxx. 


ENTRY POINT: IEAVNP20 


PURPOSE: 
IEAVNP20 is the RIM that processes SYS1.PARMLIB 
member CLOCKx~x. 


LINKAGE: CALL 
CALLERS: NIP Control/Services Routine (IEAVNIPM) 
INPUT: NIP Parmtab (pointed to out of the NIP Vector Table - NVT) 


OUTPUT: 
TPCPRMPT in the TPC set to one if the TOD Clock is in the 
not set state. Also see Statement Subfunction Routine 
entry points. 


EXIT NORMAL: Return to IEAVNIPM 
ENTRY POINT: IEAVOPER 


PURPOSE : 
IEAVOPER is the OPERATOR Statement Subfunction 
Routine. IEAVOPER processes the OPERATOR statements 
from SYS1.PARMLIB member CLOCKxx. IEAVOPER is 
invoked once for each OPERATOR statement in each 
SYS1.PARMLIB CLOCKxx member specified, and once 
for end-of-processing (after all OPERATOR statemonts 
specified, if any» have been processed). 


LINKAGE: CALL 
CALLERS: General Parmlib Scan Routine (IEEMB888) 
INPUT: Statement Processor Parameter List (IEEZB321) 


OUTPUT: 
TPCPRMPT in the TPC updated according to the first 
OPERATOR statement specification, as long as no errors 
were detected on the OPERATOR statements. 


EXIT NORMAL: Return to caller 
ENTRY POINT: IEAVTZ 


PURPOSE: 
IEAVTZ is the TIMEZONE Statement Subfunction 
Routine. IEAVTZ processes the TIMEZONE statements 
from SYS1.PARMLIB member CLOCKxx. IEAVTZ is 
invoked once for each TIMEZONE statement in each 
SYS1.PARMLIB CLOCKxx momber specified, and once 
for end-of-processing (after all TIMEZONE statements 
specified, if any,» have been processed). 


LINKAGE: CALL 

CALLERS: General Parmlib Scan Routine (IEEMB&888) 
INPUT: Statement Processor Parameter List (IEEZB821) 
OUTPUT: 


CVTTZ in the CVT updated according to the first 
TIMEZONE statement specification, as long as no errors 
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Diagram 65 CLOCK Processing Resource Initialization IEAVNP20) Part 2 of 11 
IEAVNP20 = MODULE DESCRIPTION (Continued) 


were detected on the TIMEZONE statement. 
EXIT NORMAL: Return to caller 
EXTERNAL REFERENCES: 
ROUTINES: IEEMB888 - General Parmlib Scan Routine 


CONTROL BLOCKS: 
CVT - Communications Vector Table (R,W) 
IEAPPNIP - NIP Parmtab (R) 
NVT - NIP Vector Table (R) 
TPC - Timer Supervision Work Area (R>W) 


TABLES: 
IEEZB819 - General Parmlib Scanner Parameter List (W) 
IEEZB821 - Statement Processor Parameter List (R) 


SERIALIZATION: Serialized by IEAVNIPM 
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Diagram 65 CLOCK Processing Resource Initialization ((EAVNP20) Part 3 of 11 
IEAVNP20 - MODULE OPERATION 


IEAVNP20 processes SYS1.PARMLIB member CLOCKxx. 

Main entry point IEAVNP20 invokes IEEM8888 (General 
PARMLIB Scan Routine) to scan the NIP Parameter 
Table for a CLOCK specification, read the contents 
of the CLOCKxx members specified, and call the 
statement subfunction routines, IEAVOPER and IEAVTZ. 
IEAVOPER processes the OPERATOR statements found 

by IEEMB888 and entry point IEAVTZ processes the 
TIMEZONE statements found by IEEMB&8ss. 


The OPERATOR statement from SYS1.PARMLIB member 
CLOCKxx has the following format: 


OPERATOR PROMPT or 
OPERATOR NOPROMPT 


The TIMEZONE statement from SYS1.PARHMLIB member 
CLOCKxx has the following format: 


TIMEZONE E.hHh.mm.ss or 
TIMEZONE W.hh.mn.ss 


where hh.mm.ss represent hours, minutes, and seconds, 
with minutes and seconds optional. 


RECOVERY OPERATION: 

Within NIP, IEAVNP20 operates as a RIM 
under IEAVNIPM. IEAVNP20 does not 
establish a recovery environment since 

RTM services have not yet been established 
and NIP traps abnormal conditions (e.g. 
ABENDs and program checks) such that a 
permanent system wait state results. 
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Diagram 65 CLOCK Processing Resource Initialization (IEAVNP20) Part 4 of 11 
Cc IEAVNP20 - DIAGNOSTIC AIDS 


ENTRY POINT NAMES: IEAVNP20 
IEAVOPER 
IEAVTZ 
MESSAGES: 
The following message is issued by IEAVNP20, using the NIPWTO 
service. It is issued unconditionally when CLOCK member processing 
1s complete. 
IEA598I TIME ZONE = E/W.hh.mm.ss 
Using the NIPPRMPT service causes the following existing message 
to be issued by IEAVNP20. It is issued when an error is detectad in 
a statement or in the Parmtab specification of CLOCKxx members. 
ITEA906A RESPECIFY CLOCK PARM OR ENTER EO8 
The following messages are issued by the Statement Subfunction 
Routines, using the NIPWTO service. They are issued upon detection 
of the particular error condition described. 
IEA599I CLOCKxx LINE nnnn: &&&&&&&& STMT IGNORED. UNRECOGNIZED PARM. 
IEA600I CLOCKxx LINE nnnn: TIMEZONE STMT IGNORED. VALUE NOT VALID. 
IEA601I CLOCKxx LINE nnnn: DUPLICATE &&&&&&&& STMT IGNORED. 


nnnn - indicates line number containing the error 
&&&%828% - indicates the statement type in error, either GPERATOR 


C or TIMEZONE 


ABEND CODES: None 
WAIT STATE CODES: None 


RETURN CODES: 
ENTRY POINT IEAVNP2O: 
EXIT NORMAL: 
Register 15 = 0 - Processing completed 
ENTRY POINT IEAVOPER: 


EXIT NORMAL: 


I 
ow] 
I 


Register 15 Processing completed successfully 


20 - Error detected in an OPERATOR 


statement 
ENTRY POINT IEAVTZ: 
EXIT NORMAL: 
Register 15 =0 = Processing completed successfully 
20 - Error detected in a TIMEZONE 
statement 
( REGISTER CONTENTS ON ENTRY: 


ENTRY POINT IEAVNP20: 
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Diagram 65 CLOCK Processing Resource Initialization (EAVNP20) Part 5 of 11 


ITEAVNP20 = DIAGNOSTIC AIDS (Continued) J 
Register 0 Unde fined 
Register 1 Undefined 
Register 2 Address of the NIP Vector Table (NVT) 


Address of the CVT 

Unde fined 

Address of an 18-word save area 
Return address 

Entry point address 


Register 3 
Register 4-12 
Register 13 
Register 14 
Register 15 


ENTRY POINT IEAVOPER: 


Register 0 = Undefined 

Register 1 = Address of a word which contains the 
address of IEEZB821 

Undefined 

Address of 18-word save area 

Return address 

Entry address 


Register 2-12 
Register 13 
Register 14 
xnegister 15 


ENTRY POINT IEAVT2: 


Register 0 = Undefined 

Register 1 = Address of a word which contains the 
address of IEEZB821 

Unde f ined 

Address of 18-word save area 

Return address 

Entry address 


Register 2-12 
Register 13 
Register 14 
Register 15 


REGISTER CONTENTS ON EXIT: 





ENTRY POINT IEAVNP2O0: 
EXIT NORMAL: 


Restored 

Address of an 18-word save area 
Return address 

Return code 


Register 0-12 
Register 13 
Register 14 
Register 15 


ENTRY POINT IEAVOPER: 
EXIT NORMAL: 


Restored 

Address of 18-word save area 
Return address 

Return code 


Register 0-12 
Register 13 
Register 14 
Register 15 


ENTRY POINT IEAVTZ: 
EXIT NORMAL: 


Restored 

Address of 18-word save area 
Return address 

Raturn code 


Register 0-12 
Register 13 
Register 14 
Register 15 
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Diagram 65 CLOCK Processing Resource Initialization (IEAVN P20) Part 6 of 11 
C IEAVNP20 - CLOCK Processing Resource Initialization Module STEP 01 
NIP Control/Services Routine 
(IEAVNIPM ) IEAVNP20 processes SYS1.PARMLIB member 
‘N CLOCKxx. 
> 
/ 
IEAVNP20 





\ on LOADS the General Parmlib 

RO / Scan Routine (IEEMB888). 
\ Initializes paremeter list 

NO y (IEEZB819) for IEEMB888. 


Since IEEMB888 updates IEEZB819, it 
must be reinitialized for every 
invocation of IEEMB88&s8. 


ewe ee see es > = jy 
ALLDONE NO \ i CLKFLAGS 
IEAVOPER IEAVTZ / TABLSTMT 






he 
ZERO TABLSTMT —/ 
OPERATOR OPERRTN 
TIMEZONE TZRITN 
CLOCKXX TWO 


NVTPTR 


IEAPPNIP ee > 


A. If no CLOCKxx members were specified, 
sets up to process the default CLOCK 
















; 7 member, CLOCKOO. 

3 
ZERO DEFAULT 03| Calls TEEM3888 (General 
CLOCKOO Parmlib Scan Routine) to 


process the CLOCKxx 
Parmlib members. 


PSCNENTY 





PSCN 04 | Calls General Parmlib Scan 


Routine (IEEMB888) 


stv 
\e—7 IEEMB888 
PSCNP 


05, Checks the return code 
from IEEMB888. 


PSCNCVER PSCNCID 





A. On return code zero, CLOCK processing \ 
by IEEMB888 is complete. 7 | ALi.DONE | 


YES 


rPPrPrPPPPrPrPPrPrPrPrprPrprPrrrprprprrprprprprprprprprprrrpprprprprprppppp 
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Diagram 65 CLOCK Processing Resource Initialization (IEAVNP20) Part 7 of 11 
IEAVNP20 - CLOCK Processing 














OFF 
DEFAULTZ 


ZERO 









CLOCKMEM CVTPTR 
NVTPTR 


IEAPPNIP  ienieeienielesenbedesien > 


NIPPTCAN H 


— 


NVT opromssscety 


NVTCLKER 


ON 
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N47 Vv 


A 
AIB 
AIB 
A|B 
AIB 
AIB 
A|B 
A|B 
AlB 
A|B 
A|B 
AlB 
AIB 
AlB 
A|B 
A|B 
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B. On nonzero return code, issucs a NIP —“1\ 
PROMPT (msg IEA906A) to proryst the /|BADPARM 
operator to respecify the CLOCK 
parm. If the operator respecifies 
the CLOCK parm, invokes JEEMB888 
again. 


AE 


\NVT 
/ 

RNVT 
RCVT 


\ 
/|ALLGONE 


C. If the operator responds to message 
ITEA9UGA with EOB (cancel) no further 
CLOCK member processing will be done 
by IEEM8888 and the hardcoded 
defaults of no operator prompting 
and zero hours difference in local 
time and GMT will result. 


i 


If the TOD Clock is not set, 
turns on TPCPRHPTY so thet 
the operator will be 
prompted during TOD Clock 
initialization. 


\TPC 
/ 


TPCPRMPT 


\NVT 
inform the aperator of the 
time zone value set for this 

IPL. 
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return code zero L 
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Diagram 65 CLOCK Processing Resource Initialization (IEAVNP20) Part 8 of 11 


IEAVNP20 - CLOCK Processing Resource Initialization Module 
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STEP 10 


<<. 


Processes the OPERATOR /|STMTPPTR 
statements in SYS1.PAKMLIB NVTPTR 
member CLOCKxx. 


For statement entry, scans 
the OPERATOR record. 


\TPC 


/ 
TPCPRMPT 


. For first validly specified PROMPT 
parameter, turns TPCPRMPT on. 


. For first validly specified NOPROMPT 
parametar, turns TPCPRMPT off. 


\TPC 


/ 
TPCPRHPT 





C. For an invalidly specified 
parameter, issues message IEA599I 
and sets ERRFLG. 


SUFX599 
STNT599 
LINE599 
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D. If this is a duplicate OPERATOR \ 
statement, issues message IEA601I. 7|SUFX601 
STNT601 





LINE6012 


\NVT 


RNVT 
RCVT 
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Diagram 65 CLOCK Processing Resource Initialization (IEAVNP20) Part 9 of 11 
IEAVNP20 = CLOCK Processing Resource Initialization Module STEP 12 
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snecification on a TIMEZONE NVTPTR 
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STMT PARM / 
STMT For statenent entry, scans 
the TIMEZONE record. 
> N\ 





code zero. 


[23] Returns to ITEEMNBS888. 


\ f \ 
‘esate 
RC 
For an end-of-processing 
entry from IEEMB888, checks 
ERRFLG and STMTERR. 
If ERRFLG is on or STMTERR is on, sets 
return code twenty else sets return 





/ | CONVERT 


N 7 


A. For TIMEZONE statement of incorrect 
length,issues message IEA599I and sets 
ERRFLG. 


N 4 YM 


B. If direction specified is not E (East) 
or W {West), issues message IEA600I 
and sets ERRFLG. 
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Diagram 65 CLOCK Processing Resource Initialization (IEAVNP20) Part 10 of 11 


IEAVNP20 - CLOCK Processing Resource Initialization Module STEP 16 
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If delimiter between hours, minutes, 
and seconds specified is not a period 
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Diagram 65 CLOCK Processing Resource Initialization QEAVNP20) Part 11 of 11 

















ITEAVNP20 = CLOCK Processing Resource Initialization Module STEP 16C 
------------ >| |IBIC] C. Validates hours (hh). If the value \ 
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\CVT 


units. 
/ 
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STMT 
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ocee cra --- > F. If this is a duplicate TIMEZONE 
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For an end-of-processing 
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Diagram 66. [OS Parameter Initialization (IEAVNPF2) Part 1 of 2 
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4 Process |OS parameter. 


a. Check record in 
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c. Process valid HOT!IO 
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internal text block. 
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Diagram 66. IOS Parameter Initialization (IEAVNPF2) Part 2 of 2 


Extended Description Module Label 
IEAVNIPM calls the input/output supervisor {1OS) RIM, 

IEAVNPF2, to process the |OS parameter. |OS options 

are specified at initialization by the |OS=xx system param- 

eter. The 1OS RIM reads member |ECIOSxx from 

SYS1.PARMLIB and scans the control statements in this 

member for valid syntax and for command type. 


The |OS RIM also obtains storage for the device statistics 
table. 


1 The IOS RIM issues a GETMAIN (storage form) for IEAVNPF2 DSTPROC 
common pageable storage (subpool 241} and builds 

the device statistics table. This table is pointed to by the 

statistics table header, which was built during system 

generation. The table consists of pointers, one entry for 


every 2560 bytes of storage. 


2 The lOS RIM verifies the IOS parameter, If the [OS 

parameter was not specified, the RIM returns control 
to IEAVNIPM, Otherwise, the RIM checks the ‘xx’ value. 
If it finds a syntax error, it prompts the operator for a 
correct value. 


VLDLOOP 


3 The lOSRIM calls IEAVNPM4 to read one record at a [EAVNPM4 


time from member IECIOSxx of SYS1.PARMLIB. 


4G ThelOS RIM checks the return code from IEAVNPM4. 
If |EAVNPM4 has successfully read a record from 
IEACIOSxx, the [OS RIM processes the record. 


a. It uses its internal control word table to determine if IEAVNPF2 
the record contains a valid control word ‘MIH’ or 

‘HOTIO’. If it does not, the RIM writes an error message, 

then reads the next record from [ECIOSxx, Otherwise, 

the RIM checks the syntax of the keywords in the 

operand field. If the RIM finds syntax errors, it issues 


message 1EA4191 containing a description of the error. 


BLOBLK1 


CARDRTN 


b. For valid MIH keywords, the RIM builds an internal text BLOBLK1 


block for each keyword. Valid MIH keywords are: 


INTERVAL=mm:ss 
DASD=mm'ss 
TIME=mmi:ss 

DEV =devlist 
devtype=mm iss 


where mm indicates minutes, ss indicates seconds, devlist MIHCRONO 
is a list Of One or more devices, and devtype is either 


3330V or 3851. The TIME and DEV keywords must 


Extended Description Mo dule Lebel 
be specified together. The 3330V and 3851 keywords 
are not really recognized by this RIM, but are simply 
passed along in an internal text block for processing by 
the missing interrupt handler (MIH). Aninvalid keyword 
on a record does not cause the entire record to be con- 
sidered invalid. For example, if the record contains: 


MIH TIME=05:00, DASD=FF:25, DEV=3CO, 


the 1|OS RIM issues two error messages: one message 
indicates the invalid operand following the DASD key- 
word and the other message indicates that the characters 
from the beginning of the invalid operand field (F F:25) 
to the next valid delimiter are skipped. It will also build 
an internal text block that describes the valid TIME 
and DEV keyword values. If, however, a TIME or DEV 
keyword is invalid, both keywords are considered invalid 
and the |OS RIM issues an error message. Processing 
for all internal text blocks will be done by MIH initial- 
ization in IOSRMIHT. For a description of IOSRMIHT 
see the JOS section of System Logic Library. 


c. For valid HOTIO keywords, the RIM updates the HIOT 
{hot |/O detection table) to reflect the information 
specified. Valid keywords are: 


o OVTHRSHEnnn (OVTHRSH has a maximum value of 
32, 767) 

e DFLT110=(non-recursive, recursive action) 

DFLT111=(non-recursive, recursive action) 

e OFLT112=(non-recursive, recursive action) 


VLDLOOP 


BLOMSGBK 


Valid values for recursive and non-recursive recovery 
action are: 


BOX — box the device 

CHPK — perform channel path recovery 

CHPF — perform channel path offline 

OPER — obtain recovery action from the operator 


An invalid keyword causes only that keyword to be 
considered in error. Any other valid keyword on the 
record will be processed and the HIDT updated. The 
only exception occurs when an invalid delimiter is 
placed in the variable length operand field of DVTHRSH 
and preceded by a valid ODF LT11x keyword. In this 
case, everything from the error on in the control card is 
ignored. 


& When the return code from IEAVNPM4 indicates that 

it has reached the end of IECIOSxx, the IOS R1M puts 
the address of the first internal text block in IOCMIHCA 
and returns control to IEAVNIPM. 
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Diagram 67. Volume Attribute List Processor (IEAVNP15/IEAVAP00) Part 1 of 2 
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3 Set the predefined 


DASD volume attributes. UCBBPUB (Public) 


or 
UCBBPRV (Private) 
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IEAVNIPM 
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Diagram 67. Volume Attribute List Processor (IEAVNPIS/IEAVAP00) Part 2 of 2 


Extended Description Module Label 


IEAVNIPM calls the volume attribute RIM, IEAVAPOO, 
to initialize UCBs with mount and use status information 
about direct access data set volumes. 


Note that IEAVNIPM knows this module as IEAVNP15. 
IEAVAPOO is an entry point in IEAVNP15. 


1. ‘The RIM invokes the UCB scan service (IOSVSUCB) IEAVAPOO = INITUCBS 
in IOS to obtain the addresses of all UCBs for direct 

address devices. If the RIM finds a UCB that represents a 

direct access device that contains a permanently resident 

volume, it sets the use status to public (bit UCBBPUB). 


2  =iIf the RIM finds a UCB that represents a direct access INITUCBS 
device with no volume mounted (field UCBVOLI is 
zero), it sets the not ready flag on (UCBNOTRD). 


3 ~The installation can specify mount and use attributes 
for direct access volumes by entering the attributes in 
member VATLSTxx of SYS1.PARMLIB. Using the VAL 
system parameter, the installation specifies the suffix for SYSPARMS 
VATLSTxx. The RIM checks field VAL in PARMTAB 
to determine whether a suffix is specified. 


If no suffix is specified, the R!M uses default member 


VATLSTOO. The RIM reads the entries in the specified RDENTRY 
VATLSTxx member. If the RIM finds an entry for a SETSTAT 
mounted volume, the RIM sets the appropriate use and 

mount status bits in the associated UCB. If the volume is MOUNTLST 
not mounted, the RIM issues a mount request to the oper- 

ator unless the volume is a mass storage system (MSS) VIRTMONT 
volume. For an MSS volume, the device must be online. CKPATH 


If it is not, the RIM calls IOSVNPTH to verify a path 

to the device. If a path exists, the RIM issues a MSSC 
MOUNT macro to mount the volume. After the oper- 

ator mounts the volume, the RIM sets the mount and 

use status in the associated UCB when the device is 

ready. If the operator cannot find a volume or if a device 
is Not available, the operator replies to the RIM with a 
request to bypass attribute processing for the device. For a 
description of member VATLSTOO, see /nitialization and 
Tuning Guide. 
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Diagram 68. Time-of-Day Clock Initialization (IEAVRTOD) Part 1 of 6 
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2. Check the status of the 
peececk TOD clock. 


3 Set flags for step 4 processing: 


Return codes from Step 2 
Register 15 fo If clock synchronized 
and set. 
Register 15 [4 If clock set or status 
could not be determined. 





TCWA 


Address of 


Register 15 
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Diagram 68. Time-of-Day Clock Initialization (IEAVRTOD) Part 2 of 6 
Extended Description Module Label 


Time-of-day clock initialization, invoked by IEAVNPOO, JIEAVRTOD IEAVRINT 
sets the TOD clock on the IPL processor to the correct 

GMT (Greenwich Mean Time) and initializes the local time 

and date in the CVT. The TOD clock, a 64-bit counter, 

holds the time elapsed at Greenwich since 0000 hours, 

January 1, 1900. Bit position 51 of the TOD clock is 

incremented every microsecond. The time Zone constant 

in the CVT contains the difference between the time of day 

at Greenwich and local time. 


Note: Detailed descriptions of routinas called by IEAVRTOD 
appear in System Logic Library. 


IEAVRINT does not require operator input if the clock 
referenced by the IPL processor is set. To ensure the oper- 
ator does not change aclock known to be correct, an instal- 
lation can specify in SYS1.PARMLIB (using the OPER- 
ATOR statement ina CLOCKxx member) that during 
initialization the operator not be allowed to enter a re- 

ply when the clock is set (OPERATOR=NOPROMPT). 
However, the operator will always be prompted in any 

of the following cases: 


@ The TOD clock is not set. 
e The installation allows operator intervention. 


When prompted, the operator can change the value of the 
TOD clock as well as the local time and/or date. 


1 JIEAVRTOD builds and initializes the TOD clock IEAVRTOD + IEAVRINT 
workarea (TCWA) for the IPL processor. This work- 

area will be used to communicate between various routines 

called during TOD clock initialization. 


2 \IEAVRTOD calls subroutine |EAVRTST to check IEAVRTOD IEAVRTST 
the status of the TOD clock. The return code in 

register 15 from IEAVRTST indicates the status of the 

TOD clock. 


QO Theclock is set. 
4 The clock ts not set. 


3  |IEAVRTOD checks the return code to initialize the IEAVRTOD IEAVRINT 
message indicator flags in the TCWA,. if the return 

code is 0, IEAVRTOD sets the flag for message |EA888A. 

If the return code is 4, it sets the flag for message 

IEA886A. 
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Diagram 68. Time-of-Day Clock Initialization (IEAVRTOD) Part 3 of 6 


Input 


TCWA message flags 


TCGyyy 





Process 






5 If the operator replies with new 
input, set TOD clock, local date 
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7 Set fields to zero for job 
step timing. 


4 Notify operator of TOD clock status. 
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Diagram 68. Time-of-Day Clock Initialization ((EAVRTOD) Part 4 of 6 


Extended Description 
4 \IEAVRCOM issues one of two messages: 


@ Message IEA888A displays the Greenwich Mean Time 
and local times and dates and allows the operator to 
change the time or date on the IPL processor. 

@ Message IEA886A requests the time and date from the 
operator. 


5 After the operator responds to the message, |IEAVRCOM 
issues an internal SET command. The SET command 
processor sets a TOD clock on the IPL processor if the 
operator’s reply requires it. Message |EA903A requests 
that the operator enable the clock security switch at the 
exact moment the entered time occurs. If the operator’s 
reply does not require the TOD clock to be set, SET 
command processing changes the local date and/or time 
zone constant. 


For a detailed description of SET command processing. 
refer to System Logic Library. 


IEAVRCOM then issues message IE A888A for approval 
of the current values or for new operator input (a new 
GMT or new local time and/or date). This process of 
setting the clock and issuing the message repeats until the 
operator finally approves message |EA888A by not enter- 
ing a change. 


G6  IEAVRTST again tests the clock to ensure successful 
operation so far. The return code from IEAVRTST 
is eventually passed back to IEAVNPOO. 


if the clock was set successfully, IEAVRTOD determines 


if asyne check is outstanding. If so, IEAVRTOD sets the 


return code to 24 and resets TPCSY WNC to Zero. 


J  \IEAVRTOD updates the elapsed job step timing 

field in the ASCB. A list of pointers to the ASCBs 
for all existing address spaces is contained in the ASVT 
pointed to by CVTASVT. 


Module Label 


IEAVRTOD IEAVRCOM 


[EEQ603D 


IEAVRTOD IEAVRCOM 


IEAVRTOD IEAVRTST 


IEAVRTOD IEAVRINT 
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Diagram 68. Time-of-Day Clock Initialization (IEAVRTOD) Part 5 of 6 
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Diagram 68. Time-of-Day Clock Initialization (IEAVRTOD) Part 6 of 6 
Extended Description Module Label 


8 IEAVATOD invokes |EEVIOSR to initialize fields for IEEVIOSR 
|/O measurement. These fields indicate whether SRM 
is receiving data based On an incorrect clock. 


Q = iThe real time queue contains TOQEs (timer queue IEAVRTOD TOEINIT 
elements) that expire at a particular time of day. 
The order in which the elements expire determines the 
order of the elernents in the queue. The first element of 
the queue is the one that expires next. Certain TOEs 
created for system functions are placed directly in the TPC 
(timer work area)—for exampie, the midnight TQE which 
expires every midnight and the job step timing TQE which 
expires every 10 seconds. Other TQEs created for problem 
programs are chained in the real time queue but are not 
located in the TPC itself. 


10 If CVTNIP=0, indicating NIP has completed, IEAVRTOD TOEINIT 
IEAVRTOD issues a SYSEVENT macro instruction 

when a clock has been initialized. |EAVNPOO issues an 

initial SYSEVENT for TIMER when all processors are 

online and the TOD clock(s) are initialized. 


11 IEAVRTOD initializes the host ID in the CVT. The 
host ID contains the current CPU address, CPU serial 
number, model number, and left half of TOD clock. 
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Diagram 69. Reconfiguration Processor Initialization (IEAVNP00) Part 1 of 8 
IEAVNPOO - MODULE DESCRIPTION 


DESCRIPTIVE NAME: Reconfiguration Processor Initialization 
FUNCTION: 
Initialize the IPL processor's clock and console 
RESTART text, and bring online and initialize the 
non-IPL processors in the hardware configuration. 
ENTRY POINT: IEAVNPOO 
PURPOSE: See FUNCTION. 
LINKAGE: BALR R14,R15 
CALLERS: IEAVNIPM 
INPUT: SCP INFO data from the service processor. 
OUTPUT: All processors online and ready for work. 
EXIT NORMAL: Return to IEAVNIPM via BR 14 
EXTERNAL REFERENCES: 
ROUTINES: 
IEAVRTOD - Timer Initialization Routine 
IEEVCPR - CPU Reconfiguration Routine 
DATA AREAS: SCP INFO pointed to by CVTSCPIN field 


CONTROL BLOCKS: 


5-522 MVS/XA System Init Logic 


Name Macro Description 
CPRPARMS IEEMCPR IEEVCPR Parameter List 
csD IHACSD Common System Data Area 
CVT CVT Communications Vector Table 
MSFDBLK IHAMSF Service processor data block 
MSFCMDWD 8 IHAMSF Service processor command word 
MSFSVCPL IHAMSF SVC 122 parameter list 
NVT ITHANVT IPL/NIP Vector Table 
PCCA IHAPCCA Processor Control Communications Area 
PSA ITHAPSA Prefixed Save Area 
SCCB IHASCCB Service Call Communications Block 
SCPINFO IHANSF SCP INFO data mapping for MSSF 
SPCS IEEMSPCS Service processor Call SVC 
Inter face 
SVT IHASVT Supervisor Vector Table 
SERIALIZATION: IEAVNPOO ENQ's on the SYSZVARY,CPU resource exclusively. 
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Diagram 69. Reconfiguration Processor Initialization (IEAVNP00) Part 2 of 8 
IEAVNPOO - MODULE OPERATION 


p= 
. 


6. 


7. 


Call IEAVRTOD to initialize the IPL processor's TOD clock. 
If processing 1s not under VM) invoke the service 
processor to write the console restart text to the console 
screen of this CPU. 

Set up VF parameters in the CSD. 

If the service processor architecture is supported, and 
the TOD clocks are out of sync,» 

take all other CPUs physically offline. 

Call IEEVCPR to bring each of the non-IPL processors in 
the system online. 

Issue a SYSEVENT to inform SRM that clocks are now 
synchronized. 

Return to the caller. 


RECOVERY OPERATION: 
There is no recovery for this module because this is a 
NIP RIM. 
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Diagram 69. Reconfiguration Processor Initialization (IEAVNP00) Part 3 of 8 
IEAVNPOO - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAVYNPOO 


MESSAGES: 


IEA846I SYSTEM CONSOLE INTERFACE UNSUCCESSFUL. 

RESTART OPTIONS MAY NOT BE INITIALIZED ON CPU x (lyyyy) 
The service processor supports the WRITE RESTART TEXT 
comnand but was unable to write the text to the console. 


IEA953I UNABLE TO INITIALIZE CPU x,» reason text 
Module IEEVCPR could not bring the target CPU online with 
one of the following reason texts: 

ESTAE COULD NOT BE SET UP 

CALL TO SERVICE PROCESSOR FAILED 
INVALID CPU ID 

TARGET CPU IS IN ANOTHER PARTITION 
CPU IS IN AN S/M/ZR CONFIGURATION 
SERVICE PROCESSOR FAILED 

UNABLE TO OBTAIN WORK AREA STORAGE 
MAX NUMBER OF CPUS ALREADY ONLINE 
INITIAL CPU RESET FAILED 

SET PREFIX SIGP FAILED 

RESTART SIGP FAILED 

WAKEUP ROUTINE DID NOT GET CONTROL 
WAKEUP ROUTINE DID NOT COMPLETE 
CLOCKS COULD NOT BE SYNCHRONIZED 


ABEND CODES: None 
WAIT STATE CODES: None 
RETURN CODES: None 


REGISTER CONTENTS ON ENTRY: 


Registers 0-1 - Irrelevant 

Register 2  - Address of the NVT 

Register 3 ~ Address of the CVT 

Registers 4-12 - Irrelevant 

Register 13 £- Address of standard register save area 
Register 14 - Return address to IEAVNIPM 

Register 15 #$- Entry address 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 


Registers 0-15 - Unchanged 
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Diagram 69. Reconfiguration Processor Initialization (IEAVNP00O) Part 4 of 8 


IEAVNPOO - Reconfiguration Processor Initialization STEP 01 


IEAVNIPM 










\ 
> 


/ 
TEAVNPOO 








PCCA J sone eee--- > 





ITHAMNSF J oe oe oe OD oe ee oe > 
IHAMSF sp > 


MSFDATA 


LOOPMSF 
ITHAMSF qc > 
THAMSF ap > 


MSFDSRSP 


MSFDBRSP 
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Initialize the IPL processor's clock and 
console RESTART text, and bring online and 
initialize the non-IPL processors in the 

hardware configuration. 






Invoke the timer module to 
initialize the TOD clock of 
this processor. 


If this processor is not 
running under VM, invoke the 
service processor to write 
the rastart text for this 
CPU's console screen. 





Initialize the service processor ——-\ THAMSF 
command, data block header and parameter / 
list. MSFDBLK 


MSFDBLNG 
MSFCMDWD 
MSFCMD 


Copy the console restart text from the 
area pointed to by the CVT to the 

service processor data block. MSFCMDDP 
MSFCMDID 
MSFSVCDA 


MSFSVCCA 


\THAMSF 


/ 
MSFDBRSP 





Invoke the service processor up to three 
times to write the console restart text. 









If the service processor was given the 
command, and the command was 
successfully executed or else a 
non-retryable error occurred, do not 
reissue the SVC. 


If the service processor is still 
functioning, wait for one second before 
reissuing the SVC. Otherwise, leave the 
loop without retrying. 


STIMER 


WAIT, BINTVL=ONESEC 


yoy 
\r77 


. If the service processor supports the | 


console restart text function but failed | 
to write the restart text to the | 
console, Issue message IZA&4¢6l. 
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Diagram 69. Reconfiguration Processor Initialization (IEAVNP00) Part 5 of 8 
IEAVNPOO - Reconfiguration Processor Initialization STEP 03 





f-—N 
\rm7Z ITEAPMNIP 


TYPE=WNTO> PARAM=M846LNE1 










suo 
\c—7 IEAPMNIP 
TYPE=WTO, PARAM=M846LNE 2 
CVT Eeteneiebeteetetet > 03 Set up the vector parameters \CVT 
-: \ in the CSD and set up to / 
° / loop through the SCP INFO CVTVPRM 
: CPU entries. 


SCCB 
IHAMSF 


SCCB 


IHANSF \ Loop through the SCP INFO 

/ CPU entries and determine 
which CPUs are physically 
Online. If the service 

CVT processor architecture is 

supported, take the nonIPL 

CPUs physically offline. 





SCPNCPS SCPOCP 


SCCE prccccccces >| A. If this CPU is the IPL processor and has \CSD 


-: \ a connected vector, bring the VF / 
SCCBCPA SCCBVFCN| : 


/ logically online to MVS. CSDCPUVF 
CVT 


CVTSVPRC 


CSD 


CSDMASK CSDCPUVF 


IHAMSF \| B. If this CPU is not the IPL processor, 
/ determine if it 1s online by issuing a 
SCPCPA SIGP SENSE. 
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Diagram 69. Reconfiguration Processor Initialization (IEAVNP0O) Part 6 of 8 










IEAVNPOO - Reconfiguration Processor Initialization STEP O04C 
ITHAMSF prcccccco- >| C. If this CPU is not the IPL processor, \IHANSF 
=: \ and it is physically online, Keep a / 
MSFDBLK MSFDBRSP| : / record of this and, if this processor MSF DBLK 
MSFCMDWD MSFSVCPL] : supports the service processor 
: architecture, and the TOD clocks are out 
CVT : of sync, take the CPU physically 
—l offline. 
MSFSVCCA 
cSsD < > 
CSDMASK 
ITHANSE 
SCPCPA 
SPCS 
SPCSESVC 
ITHAMSF Sn >| D. If the processor could not be taken 


\ physically offline, save it's logical ID 
/ so that it will be the first one brought 
online to MVS. 


If other processors were 


online, prepare to interface 
With IEEVCPR, the CONFIG CPU 
routine. 


MSF DBRSP 


THANSF 






A. Serialize this entry to IEEVCPR. 


(SYSZVARY, CPU, E, » SYSTEM) 


B. Bring the routine into storage.dHl 


EP( "IEEVCPR’ ) 



















06 If a processor could not be \IEEMCPR 
taken physically offline, 7 
invoke IEEVCPR to bring that CPRPARMS 
one online to MVS first. If CPRCPUAD 
a TOD clock synchronization 
problem exists, the 
processor having the bad 


clock can then be 
identified. 


as 


\rcu7Z CONFIGCP: 11 
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Diagram 69. Reconfiguration Processor Initialization (TEAVNP00) Part 7 of 8 








IEAVNPOO - Reconfiguration Processor Initialization STEP 07 
IEEMCPR —s pew en nnnne- > 
J \ 
; 
CSD 

> Loop through all processors, \TEEMCPR 

\ bringing logically online / 

/ (and physically online where CPRPARMS 
necessary) each processor CPRCPUAD 
that was physically online 
(as determined by the 
previous SIGP SENSE). 

sU—IN 
a 
CSD \ 
/ 


CSDMASK 
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Cleanup resources previously 
obtained. 


A. Delete CF CPU routine. 


DELETE 
EP( 'IEEVCPR' ) 


B. Release serialization resource for 
IEEVCPR. 












(SYSZVARY, CPU, ,» SYSTEM) 


09 Inform SRM that the CPU TOD 
Clocks are now synchronized. 


is’ 


\r—77 SYSEVENT 
TIMEREXP 


Return to the caller. C | 
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Diagram 69. Reconfiguration Processor Initialization (TEAVNP00) Part 8 of 8 


IEAVNPOO = Reconfiguration Processor Initialization 


/ 
CONFIGCP 


jaa ‘ 


IEEMCPR pos > 


IEEMCPR po > 
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Configure a designated 
processor online. If the 
processor was not 


successfully configured, 
issue an appropriate 
message. 





Invoke IEEVCPR to bring the 
processor online. 


seo 


\r—7 IEEVCPR 


CPRPARMS 


If IEEVCPR's return code 
indicates that the target 
CPU was not brought online; 
issue message IEA953I. 


seu—lN 
\rn7 


TYPE=WTO, PARAM=IEA953I1 


If the CPU is now online; 
but IEEVCPR could not write 
the restart text, take the 
service processor 
reason/response code from 
the high order half of 
register 15, insert it into 
message TEA8G6I and issue 
1 o 


Jue 
\rn7 
TYPE=NTO, PARAM=M846LNE1 


soe—lN 
\rn172 


‘TYPE=WTO, PARAM=M846LNE2 


Return to the subroutine 
caller. 


“ 
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STEP 11 


\IEEMCPR 


/ 
CPRONCM 
CPRCPU 
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Diagram 70. NIP Exit Processing (IEAVNIPX) Part 1 of 4 


IEAVNIPM 


Input Process Output 


1 Release the NIP system 
parameter element 
queue. 


NVTMSTCR 


NVTSPE 


Master scheduler 
TC8 


TCBLLS 


2 Release the queue of 
programs loaded by 


TCBJPOB NIP. 








Master scheduler 
TCB 


TCBLLS = 0 


TCBJPQB = 0 
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Diagram 70. NIP Exit Processing (IEAVNIPX) Part 2 of 4 


Extended Description Module Label 


The NIP RIM, IEAVNIPX, performs final exit and clean up IEAVNIPX NPXFBUF 
processing before passing control to master scheduler initiali- 

zation. NIP removes itself from the system, including its 

control blocks, buffers, and error traps. 


1 NIP obtains the origin of the NIP system parameter 
element (SPE) queue from field NVTSPE. NIP frees 
each SPE on the queue except the SPE contained in the 
NVT. NIP frees the SYS1.NUCLEUS DCB and DEB that 
IEAVNIPO obtained from the non-extended SQA (subpoo! 
245). NIP also generates the IEAPMNIP interface to invoke 
NIPWTOR2 to free the master console image buffer. Fora IEAVNPM2 NIPWTOR2 
map of virtual storage an exit from [EAVNIPX, see Figure 
1-6. 


2 ~=After acquiring the local jocks, NIP dequeues the LLEs {fEAVNIPX NPXFJPQ 
(load list elements) and CDEs (contents directory 

entries) representing programs that NIP has loaded that re- 

main on its TCB job pack queue (TCBJPQOB). NIP then 

releases the storage that the LLEs and CDEs occupy. 


When dequeueing LLEs, NIP first dequeues each LLE 

from the TCB under which NIP executes (the master 
scheduler TCB), starting with the LLE pointed to by field 
TCBLLS. Before it releases the storage occupied by each 
LLE, NIP updates the TCBLLS pointer to point to the next 
LLE. Processing is complete when the TCBLLS pointer 

is zero. 


NIP then dequeues the CDEs from the master scheduler TCB. 
NIP dequeues each CDE pointed to by the TCBJPQB field. 
Before dequeueing each CDE, NIP tests the extent list 
created flag in the CDE to determine whether an extent list 
is associated with the CDE. If an extent list exists, NIP also 
releases the storage containing the extent list. If no extent 
list exists, NIP continues with the next CDE. NIP updates 
the TCBJPQB pointer with the address of the next CDE, 
dequeues the CDE, and releases the storage containing the 
dequeued CDE. Processing is complete when the TCBJPOB 
pointer is zero. 


NIP then releases the local locks. 
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Diagram 70. NIP Exit Processing (IEAVNIPX) Part 3 of 4 


Input Process Output 


NVT 


z 


VT 
3 Remove NIP traps: 


eneve @ ABEND trap NVTSVCTB 


table entry 


ooT nur waisks VX/SAW ZEC-¢ 


SVC table 
CC 
(NVTLOCAT) 
LOCATE SVC @ LOCATE trap SVC D entry 


table entry 


(NVTRTMSA) 
4 RTM branch 
entry table 


SVC 1A entry 
e RTM trap 


VT 





RTM1 table 


CVTBTERM 


'?) 


VT 
CVTNVTO 


4 Free the NVT. CVTNVTO 


—| 


LDA CB 


(LDASRD) 
system region 
descriptor 


| Fe 
il 


| 
< 
i 


TCBRD 
5 Free NIP address space. 


TCBERD 


(LDAESRD) 
system region 
descriptor 
extended 
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Initialization (IEEVIPL) 
Diagram 65 
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Diagram 70. NIP Exit Processing (IEAVNIPX) Part 4 of 4 


Extended Description Module Label 


3 3 NIP removes traps that were set by NIP in IEAVNIPM. IEAVNIPX NPXRTRAP 


e NIP removes the ABEND SVC trap by moving the 
ABEND SVC table entry from the NVT save area 
(NVTABSAV) into the SVC 13 entry in the SVC table. 

@ NIP removes the LOCATE SVC trap by moving the 
LOCATE SVC table entry from the NVT save area 
(NVTLOCAT) into the SVC 26 entry in the SVC table. 

@ NIP removes the recovery/termination management 
trap by moving the address of the RTM1 table from the 
NVT save area (NVTRTMSA) into field CVTBTERM 
inthe CVT. 


NIP frees the global storage (SQA) that was used for the 
RTM traps. 


4 NIP releases the storage in the non-extended SQA 
that contained the NIP vector table (NVT) and resets 
the pointer (CVTNVTO=0). 


& NIP moves the remaining JEAVNIPX code to the 

non-extended SQA and continues to execute. NIP 
uses the VSM routine, |GVGVRGN, to free the region in 
which it has been processing. It then sets fields in the TCBs 
to point to system regions. !t loops through each TCB in 
storage, placing the contents of LDASRD into TCBRD, and 
LDAESRD into TCBERD. 


Finally, NIP passes control (via the LINK macro instruction) 
to master scheduler initialization (JEEVIPL). 
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Diagram 71. System Address Space Create Routine (IEEMB881) Part 1 of 10 


LINK from a RIM, 

master scheduler base 
initialization (TEEVIPL), 

JES3, or from a system component 


after system initialization 
Input Process 


1 Establish s recovery 
environment. 


scheduler does not 
exist, create and 
initialize one. 





——— | 
——— BAASCB If e JSCB for the master 





Output 


CVTMSER 


TCB 


TCBJSCB 


BAASCB 
Pd 
BAMJSCB 


Cd 
JSCBTJID 


JSCBACT 
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Diagram 71. System Address Space Create Routine ((IEEMB88!) Part 2 of 10 
Extended Description Modules Label 


The system component address space routine (|/EEMB881) 
can be invoked from a RIM, the master base initialization 
routine ((EEVIPL), or any module in supervisor mode to 
create an address space for a system component. This 
processing can occur during master scheduler initialization, 
during JES initialization, or after system initialization is 
complete. (See Section 1, ‘'System Component Address 
Space Initialization” for additional information on system 
address spaces.) 


The input paramaters consist of either zero {meaning the 
parameter is not supplied) or pointers (USRATTA, 
USRPGMN, and USRPARMS) to: 


e Alist of system address space attributes 
e@ The name of the address space initialization routine 
@e The START paramaters 


USRATTR and USRPGMN are optional parameters, but 
USRPARMS must be supplied. If USRATTR is not supplied, 
fEEMB881 provides default values for the address space 
attributes. If USRPGMN is not supplied, /EEMB881 can 
create an address space but the address space wilf not be 
initialized in any special manner. If USRPARMS is not 
supplied, |IEEMB881 coes not creata the address space 

and returns to the caller with X‘04’ in both registers 15 

and 0 to indicate the error. (See stap 10 for a description 

of the raturn and reason codes.) 


The address space attributes supply the attributes normally 
obtalned from the program properties table (PPT) end the 
JCL. EATTRSMF corresponds to tha PPT preferred storage 
usage flag; EATTRTYP is a description of the eddress 

space type; end EATTRACT contains swapping Information. 


The initialization routines provided by the components 
that use [EEMB881 are listed in Section 1 under “System 
Component Address Space Initialization.” 


Extended Description Module Label 


The START parameters consist of a halfword length field 
followed by a variable length character string. This character 
string Is used as the procedure name by the DISPLAY A 
command whan displaying the new address space. (The 
procedure name must consist of 1 through 7 alphamerlc or 
natlonal characters, the first of which Is alphabetle or 
natlonal.) 


1 JEEMBSS1 establishas an ESTAE environmant using IEEMBS81 
the ESTAE recovery routine EAESTAE, which Is an 

entry point In IEEMB881. This ESTAE routine, which Is 

operative after NIP, recelves controf If an ABEND occurs 

durlng system component address space create procetsing. 


See recovery processing for datalls. 


2 IEEMB88!1 checks the SAASCEB fleld of tha master lIEEMBS81 
scheduler’s resident date srea (BASEA). If this field 

Is zero, the master scheduler’s JSCB does not exist and 

IEEMB881 Issues 0 GETMAIN to obtain storage for It 

from subpool 237; places the address of the master schedu- 

ler’s ASCB Into BAASCEB; chains the JSCB to tha master 


scheduler’s TCB; and Initlelizes the JSCB as follows: 


e Sets JSCBSWSP to Indicate thet storage for the JSCB 
came from the SWA 

e Places the address of the JSCB In JSCBACT to Indicate 
that the JSCB Is active 

@ Places the master scheduler’s ASID In JSCBTJID 
to Indicate that this JSCB was created for tho 
master schedular 

@ Sats all other flelys of the JSCB to zero. 
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Diagram 71. System Address Space Create Routine (IEEMB881) Part 3 of 10 


Input Process Output 



















Register 1 CSCB 
CHVCD 
CHINFMT 

| —“(i‘“CsCSCsS 


CHKEY 


CHCLS 
CHUNIT 


es 
CHTRKID 


Parameter list 







(4 Address space 


USRATTR attributes) 


3 Create and initialize 
a START command 
CSCB. 









USRPGMN (4 Name of address 
space Initialization routine) 


(ASTART 
parameters) 












USRPARMS 













Check the input 
parameters and 
address space 
attributes. 









CHCSCBID 
EATTLEN 


EATTFLG2 
EATTRSMF 


EATTRTYP 





Register 15 






e If Invaild 








Register O 








Return 


EATTRACT 
to caller 





START parameters 
character string 


mi 
> 
= 
| 
me) 
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Diagram 71. System Address Space Create Routine (IEEMBS881) Part 4 of 10 


Extended Description 


3 lEEMBSS1 issues a GETMAIN to obtain storage 
for a CSCB from subpool 245 (SQA) and then it 
initlallzes the CSCB as follows: 


@ Sets the CSCB to zero 

@ Stores X’04' In the verb code (CHVCD) to Indicate 
a START command Is being processed 

@ Stores the length of the CSCB In CHSZE 

e If supplied, places the name of the address space 
initlallzation routine in CHKEY 

@ Stores the START parameter character string In the 
Procedure name that can be used by the DISPLAY A 
command (CHCLS) for a limited function address 
space 

e@ If the procedure name is IEESYSAS, place the step- 
name {the name of the address space) in CHCLS. 

This permits the address space to be treated as if 
it had its own procedure. 

e Stores blenks in the start unit address fleld (CHUNIT) 
and the procedure step name fleld (CHPROCSN) 

@ Stores X'04’ In the DISPLAY/TRACK Idantifler 
(CHTRKID) to indicate thet this Is e system componant 
address spece 

@ Sets the CHINFMT bit to one to Indicate that the CSCB 
is in input format 

e@ Places the acronym ‘CSCB’ in the CHCSCBID field 


4 (JEEMBB681 checks to determine If the address space 
attributes (EATTR) and the START paremeters are 
valid. If an Invalid condition exists, IEEMB881 sets a 
return code in register 15, a reaton code in register 0, and 
returns to the caller. See step 10 for e list of these codes. 


Module 


(EEMBS81 


|IEEMBSa1 


Label 


Wal Jo Aysadoig — syetiajeya, posuzory] 


uA] J° SRI PPuUsIY,, 


1807] Wu] Waiskg VX/SAW R¢C-C 


L861 ‘7861 “50D WAI 1Y8UAdoD @ f-00ZI-8ZAT 


Input 


Register 1 
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USRATTR 





EATTA 


EATTRACT 
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CVTMSER 


CSCB (new) 





Diagram 71. System Address Space Create Routine (IEEMB881) Part 5 of 10 


5 Obtain an ASID 


and ASCB. 


elf a fallura 
occurred tn the 
memory requett 
routine 


G Store the address 


space attributes In 


the ASCB and CSCB. 


7 Add the new CSCB 


to the end of the 
CSCB chein. 











1IEAVEMRQ 


Ez 
request 





Return 
to caller 


Output 


CVTASVT 


b 


cB 


ASCBCSCB 


i 
ia 


B 


cB 


ASCBDP 


ASCBRSMF 


ASCBFLG2 


ASVT 


ASVTENTY 


rH 


CB 


CSCB 


CHACT 
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Diagram 71. System Address Space Create Routine (IEEMB881) Part 6 of 10 


Extended Dascription Module Label 


5 = Before obtaining an ASID and ASCB for the new (EEMBeBI 
eddress space, JEEMB881 enqueues exclusively on the 

CSCB chain using SYSIEFSD and Q10 as the major and 

minor queue names. This serialization of tha CSCB chaln 

prevents the master scheduler WAIT routine (IEEVWAIT) 

from updating the ASCB before tha address space Is 

created. IEEMB881 provides the address of the CSCB and 

calls memory request ((EAVEMRQ) to obtain the ASID IEAVEMRQ 

end ASCB. [EAVEMRGO stores a pointer to the ASCB in 

tha ASVT (ASVTENTY), a pointer to the CSCB In the 

ASCB (ASCBCSCB), and the ASID in the CSCB (CHASID). 

If IEAVEMRO could not obtein the ASID and ASCB, 

IEEMB88)1 sets the return code to 8, the reason code to 4, lIEEMB881 

8, or 12, frees the storage for the new CSCB, and returns to 

the caller. (See stap 10 for an explanation of these codes.) 


G6 JEEMBSS81 updates the ASCB with tha caller-supplied {EEMB8S81 
address space attributes (USRATTR) or the default 

attributes. The attributes that IEEMB881 stores in the 

ASCB include: 


e@ Address space function attributes (ASCBFLG2= 
EATTFLG2) 

e RSM storage allocation attributes (ASCBRSMF= 
EATTRSMF) 

@ Addrass spece dispatching priority (SRM sets ASCBDP 
using SYSEVENT EASINIT with EATTRTYP as the 
caller's address space type.) 


This module elso stores the callar-supplied job scheduler 
attributes In the CSCB (CHACT=EATTRACT). 


7 =‘ This module adds the newly-created CSCB to the lIEEMB881 
end of the CSCB chain enchored from BASEA. 


Wal Jo Aysadosg — syeriayeya’ pasuaory 


IAAT JO SRHIIE}, P2}94jSIY,, 


s1307] wWuy waisks VX/SAW OPS-S 


L861 ‘7861 ‘209 Wa 148AdoD © p-O07I-8Z7AT 


Diagram 71. System Address Space Create Routine (IEEMBS881) Part 7 of 10 
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Diagram 71. System Address Space Create Routine (IEEMBS881) Part 8 of 10 
Extended Description Module Label 


8 Auser must be In the master scheduler’s eddrets lIEEMB881 
space (AS!ID=1) to create en address space by invoking 

memory create (IEAVEMCR). If IEEMBBS1 is not running 

in the master echaduler’s address space, it sets the CHAP 

field of the CSCB to request JEEVWAIT (which is running in 

the master scheduler’s address space) to create an address 

space. |EEMB881 then posts the ECB BAMSIECB, 

which [EEVWAIT is waiting on. [EEVWAIT then 

attaches IEAVEMCR. 


9 If JEEMB881 Is running in the master scheduler’s ad- 

dress space, it attaches [EAVEMCR to create the system IEAVEMCR 
component address space. If the address space Is not created 
successfully (JEAVEMCR returned e nonzuro completion 
code), (EEMB8871 sets the reason code equal to the com- iIEEMB881 
pletion code end the return code equal to 24 and returns to 
the caller. 
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Diagram 71. System Address Space Create Routine (IEEMB881) Part 10 of 10 


Extended Description Module Label 


10 If the address space was successfully created, 
'EEMB881 stores the following values In the spccllied 
registers: 


@ Register 1: the address of the new ASCB 

@ Reylster 2: @ pointer to the ECBs mapped from the CSCB 
(EAERIMWT=CHRIMWT and EASASWT=CHASWT) 

@ Register 15: X‘00’ 

@ Register 0: X'O0’ if IEEMB88)I attached IEAVEMCR or 
X'04' if IEEVWAIT attached IEAVEMCR 


A summary of the decimal return codes and tha corresponding 
reason codes returned by [EEMB881 follows. If the return 
code is X00’, an address spaca was created and register 1 
contains the address of the ASCB:; If the return code is not 
X'00’, an address space was not creeted. 


Register 15 Register O Explanation 
fleturn code Reason Code 

0 0 The address space was suc- 
cessfully started. 

0 4 IEEVWAIT was Invoked to 
create the address space. 

4 4 The caller failed to specify 
USRPARMS. 

4 8 An invalid DISPLAY A 
procedure name was sup- 
plied. 

8 4 SRM would not allow 
memory request to create 
an address space. 

8 8 Memory request indicated 
that the system was over- 
loaded. 

B 12 Memory request experi- 
enced an unexpected 
system failure. 

12 4 Unsupported fleg bits are 
on In the EATTFLG2 field. 
12 8 Unsupported flag bits are 


on In the EATTRSMF field. 


Extended Description Module Lobel 
Register 15 Register O Explanation 

Return Code Reason Code 

12 12 Unsupported flag bits are 


on In the EATTRACT field. 


12 16 The user specified an 
invalid address space type. 
16 0 An ABEND took place 
during the execution of 
IEEMBS81. 
24 Return code An arror occurred In 
from IEAVEMCR. 
IEAVEMCR 
28 0 There was a failure during 


the ESTAE setup. 


Recovery Processing: 


If an ABEND occurs during address space create pro- IEEMB881 EAESTAE 
cessing, subroutine EAESTAE recelves control. If an 
SDWA axists, this subroutine performs the following 


functlons: 


e Fills In the appropriate fields and issues the SETRP 
macro specifying retry and record as options 

@ Tekes an SVC dump 

e@ Performs a retry 


if an SOWA does not exist, this subroutina: 


e Sets the registers according to standard subroutine 
linkage conventions 

e Takes an SVC dump 

e Parformse retry 


EARETRY, the retry routine, which receives control 
from RTM after EAESTAE executes, performs these 
functions: 


EARETRY 


Sats return and reason codes 

Frees the storage for the new CSCB 

Terminates the new address space (if lt was creatad) 
Releases the serialization of the CSCB chaln 


CLEANUP 
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Diagram 72. System Address Space Initialization WAIT/POST Routine (IEEMB883) Part 1 of 2 


Started task contro! processing 
(1EEPRW12) or a systein address 


input space initlalization routine Procass 



















Parameter list 
4 ASCB 


Register 1 







1 Establish an ESTAE 
environment. 





2 Validate the event 
code. 
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Diagram 72. System Address Space Initialization WAIT/POST Routine (IEEMBS883) Part 2 of 2 


Extended Description 


Started task control (STC) processing (JEEPRWI2) or a 
system address space Initialization routine calls the - 
system address space Initialization WAIT/POST routine 
(1EEMB883) to walt for master scheduler initlatizetion 
to complete. The input to the routine consists of the 
ASCB of the new system address space and an event 
code (EACOD) of 1, which identifies the event 

(master scheduler Initialization) being walted on. 


1 = The system address space Initialization WAIT/POST 
routine (JEEMB883) establishes en ESTAE environ- 
ment with WPESTAE as the recovery routine and WPRETRY 

as the retry routine. See “Recovery Processing” for detalls. 


2 JEEMB883 checks the event code. ff it is Invelid 

(not equal to 1), IEEMB&83 sats a return code of 
X'04’ end a reason code of X‘'1000’ and returns to the 
calter. 


3 sIf the event code (EACOD) Is 1, /EEMB883 waite for 
master scheduler Initialization to complete. 
{EEMBS83 does this by posting the ECB BAMSIECB to 
activate tha master scheduler wait routine (IEEVWAIT) and 
setting a bit in the CSCB (CHPOSTSS) to Inform IEEVWAIT 
that it should post the ECB CHASWT when master 
scheduler Initialization Is complate. [EEMB883 also 
turns on tha actlon-pending-dit In the CSCB (CHAP) to 
indicate to JEEVWAIT that there Is work to do. After 
{EEVWAIT has posted CHASWT, /EEM8883 regains con- 
trol and does the following: 


@ Initializes the job step control blocks (JSCBs) for the 
TCBs In the new system eddress space with Information 
copied from the master scheduler's JSCB. 

e Sets the address of the task I/O table (TCBTIOT) in ali of 
the TCBs In the new system address space to point to 
the master scheduler’s TIOT. Dumps of this address 
spece can now be taken If required. 


Module 


fEEMB883 


IEEMBS83 


{EEMB883 


IEEVWAIT 


{EEMBS883 


Extended Description Module Label 


Recovery Processing: 


If an ABEND occurs during WAIT/POST processing In 
[EEMB883, RTM passes controt to the recovery routine, 
WPESTAE. WPESTAE Is operative only after NIP. If 

en SDWA exists, WPESTAE updates it and lesues a 
SETRAP specifying the record and retry options and 

takes an SVC DUMP. If there Is no SDWA. WPESTAE 
sets registers and attempts a retry. The retry routine, 
WPRETRY, recetves contro! from RTM after the recovery 
routine, WPESTAE, executes, WPRETRY sets the return 
and reaton codes and returns to the caller of (EEMBS83. 


1EEMB883 WPESTAE 


WPRETRY 
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Diagram 73. Model System Address Space Initialization Part 1 of 2 
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Diagram 73. Model System Address Space Initialization Part 2 of 2 


Extended Dascription Module Label 


Each of the system component address spaces created vis 
the system component address space create routine 
(JEEMBS881) has its own system component address 

space initialization routine, which is specified as Input 

to |EEMB881. These routines are listed in Section 1 under 
“System Component Address Space Initialization.’’ 


This diagram describes the basic functions that these 
system address space initialization routines have in common. 


The input to system addrass space initialization routines 
consists of pointers to the ASCB of the system address 
space, a list of ECBs, and the system address space 
WAIT/POST routine (JEEMBS83). The list of ECBs 
contains two ECBs, EAERIMWT and EAEASWT. (The 
caller of IEEMB881 waits on ECB EAERIMWT, which 
is posted by the system address space initialization 
routine only If the eddress space is a full function 
address space. The system address space initialization 
routine waits on EAEASWT, which is posted by the 
caller of IEEMB881.} 


1. Each initialization routine Initializes its addrass 
space according to its own requirements. This 
Includes creating and Initlalizing control blocks, loading 
code, and performing any necessary functions. (Thage 
control blocks can ba eccessed by other eddress spaces 

via cross memory instructions.) 


Extended Description Module Label 


2 If a systein address spaca is created as a limited- 

function-address-space, the initiallzatlon routine 
calls the system address space WAIT/POST routine 
1EEMBBSB3 to ensure that master scheduler Initialization 
is complete. As Input, to IEEMB883, the initialization 
routine supplies the event code (EACOD) (set equel to 
one to Indicate a welt for mastar scheduler initielization 
to complete) and a pointer to tha ASCB of the address 
space bing initialized. IEEMB883 posts ECB BAMSIECB 
to activate the master scheduler wait routine (JEEVWAIT) 
and then waits on ECB CHASWT, which Is posted by 
IEEVWAIT when master scheduler initiallzation Is 
complete. After the system address space initialization 
routine receives control again, it performs one of the 
following functions: 


IEEVWAIT 


@ If the address space was not created successfully, 
the initialization routine returns to [EEPRWI2 
with a return code of X'04’ to indicate that the 
system address space being initialized is to be 
terminated. 

@ If the address space was created successfully, the system 
address space initialization routine goes into a never- 
ending-wait, by waiting on an ECB that is never posted. 
Either before or after calling IEEMB&83, the initialization 
routine posts ECB EAERIMWT, which the caller of 
[EEMB881 is waiting on. 


3 = ff the system address space Is 9 full-functlon-eddress System 
space, the Initlalizetion routine posts ECB eddress 

EAERIMWT, which the caller of LEEMB881 Is walting space 

on, and sets the return code. (f the address spsce was . initlalization 

created successfully, the system address space Initlalization routina 

routine sets a raturn code of zero and returns to the 

started task control processing routine (IEEPRWI2), 

which than invokes the START commend syntax routine 

(1EEVSTAR) using the START parameters supplied es 

Input to the system eddress space create routine (/EEMB881). 

If the address space was not created succossfully, tha 

initialization routine returns to IEEPRWI2 with e return 

coda of X'04’ to Indicate that the system address space 

being initletlzed Is to be terminated. 
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Diagram 74. Started Task Control Processing Part 1 of 10 
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e If requested, make the address 
space nonswappable. 
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e Perform SMF processing. 
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Diagram 74. Started Task Control Processing Part 2 of 10 


Extended Description Module Label 

The started task control (STC) routines oversee both 

the initialization of systern component address spaces 

end the processing of START, MOUNT, and LOGON 

commands. In both situations, STC processing includes 

steps | and 2. If a system component address space e 

is to be initialized, processing continues at step 3, 

where STC links to the system component address 

space Initialization routine. if the system component 

address space js initialized as a limited function address 

space, the Initialization routine goes Into a never-ending- 

walt and control does not return to STC. If the system 

component address space Is initialized as a full function 

address space, control returns to step 4 and processing e 

continues at step 5 as for aSTART command. Ifa 

START, LOGON, or a MOUNT command is being pro- 

cessed, control proceeds directly from step 2 to step 5. 

1. ‘The first STC module that receives control is IEEPRWI2 
1EFEPRWI2. This routine establishes an ESTAE environ- 

ment for STC by creating an ESTAE parameter list end load- 

Ing module IEESB665, the STC recovery exit routine. 


The ESTAE environment ensures that the recovery termi- 
nation management (RTM) routines will receive control in 
the event of an STC error. RTM will, in turn, invoke 
|EESB665, which will then ettempt to recover. 


If RTM provides a system diagnostic work area (SDWA) 
containing the necessary data, IEESB665 will schedule 
8 retry by terminating the current STC processing and 
issuing a SETRP macro Instruction. 


If no SDWA axists, IEESB665 wilt sirnply continue 
ABEND processing. 


In either case, the recovery routine will racord the error 
in the SYS1.LOGREC data set and then return to RTM. 


2 Once the ESTAE environment is complete. IEEPRWI2 
calls IGVGVRGN to obtain its own region. 


[IEEPRWI2 


Extended Description 


3 if a system component address spece is being created, 


tha caller specified e systern address space Initlaliza- 


tion routine (CHKEY contains the neme of the routine) 
end IEEPRWI2 performs the following functions: 


if the system address space is to be nonswappable 
(CHSWAP=0), IEEPRWI2 issues e TRANSWAP 
SYSEVENT. A return code of X’20’ indicates a 
TRANSWAP error, in which case an ABEND occurs. 


If the system address space is to be swappable 
(ASCB1LPU=on or ASCB2LPU=on), IEEPRWI2 
issues a REQSWAP SYSEVENT. 


If SMF has been initialized (CVTSMCA#0), IEEPRWI2 
links to the SMF routine, IF AEASIL, to schedule en 
SRB for deta gathering purposes. The SRB, when dis- 
petched, will gather SMF eccounting date, timer 
information, and procetsor statistics for limited-function- 
start address spaces that do not go through START 
processing. (The system address space initialization 
routine controls whather or not the address space 

being created goes through e limited or a full-function 
stert.) 


in order to perform the necessary initializetion, 
fEEPRWIZ2 links to the celier-supplied address space 
initlalization routine, whose name is located in CHKEY. 
(See M.O. diagram Modal System Address Space 
Initialization.) if one is not supplied, the address 

space willl not bea initialized in any special manner. 


For the module flow of started task control, see Figure 4-11. 


Module Lebel 


tEEPRWI2 


[FAEASIL 


System 
address 
space 
initialization 
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Diagram 74. Started Task Control Processing Part 3 of 10 
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Diagram 74. Started Task Control Processing Part 4 of 10 


Extended Description Module Label 


4 Ifa START for a system component address space (EEPRWI2 
is to be processed (CHTRKID=X‘04'), which means 

that the eddress space is a full function address space, 

TEEPRWI2 Initializes the event code to 1 and calls the 

system address space initialization WAIT/POST routine \IEEMB883 

(IEEMB883) to wait for master scheduler initialization to 

complete. 


5 sEEPRWI2 checks an Indicator in the CSCB to deter- 
mine which command, START, MOUNT, or LOGON, 
Is to be processed. 


lf the command is START, IEEPARWI2 issues an XCTL IEEVSTAR 
macro instructlon to IEEVSTAR. 


if the command is MOUNT, the XCTL macro instruction 1EEVMNT1 


invokes JIEEVMNT 1, and for a LOGON, IKJEF LA. IKJEFLA 

Both IEEVSTAR and IEEVMNT1 are part of STC; tEEVSTAR 

IKJEFLA is part of LOGON processing. and 
IEEVMNT1 


G Both routines, IEEVSTAR and [EEVNMT1 begin proc- 
assing by creating a start descriptor table (SDT) end 
Initializing It with blanks and zeroes. 


J JEEVSTAR and IEEVMNT1 check the commands 

and associated parameters for correct syntex. When 
elther routine finds an error, It places the command name 
In an extended save area and Invokas module JEEQ603D 
to writa a messaga using that nama. 


IEEVSTAR and IEEVMNT 1 continue error procassing by 
fraeing the SDT and Issuing an XCTL macro instruction to 
the lest routine of STC, IEEPRTN2. This module cleans 
up the data ereas and ands the task that wes begun for e 
START or MOUNT command. 


Wa] Jo Ayaadoirg — speliazey,A] posusory] 


hE JO SPRHOye YA, PIp9!43S9y,, 


o1807] muy waisks VYX/SAW ZCC-C 


L861 ‘7861 “450 WAI 1sAdoD © p-00ZI-8ZAT 


Diagram 74. Started Task Control Processing Part 5 of 10 
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Diagram 74. Started Task Control Processing Part 6 of 10 


Extended Description 


8 Every time e MOUNT command is specified, JCL that 

identifies the device to be mounted Is supplied by the 
user. When e START conimmand is specified, the JCL must 
be created for it. 


IEEVSTAR uses the START command perameter to build 
internal JCL stetements. 


The procedure name thet wes specified with the START 
command becomes the JCL jobname. The name is placed 
in the CSCB end e pointer to it in the ASCB. 


When en ID was included on the START commend, it 
becomes the stepname for an EXEC card. It too is saved in 
the CSCB. If no ID was specified, the stepnamea used is 
“STARTING”. 


If a unit parameter end volume seriel number were entered 
with START, they ere used for a DD statement. 


As each JCL stetement is generated, it is moved into the 
SDT. 


Q Both IEEVSTAR and IEEVMNT1 create command 
input buffer CIBs using storage from subpool 245. 

If the SUB operand is present on the START command, 

IEEVSTAR creates an STC communication CIB. 


Muditsle Label 


(EEVSTAR 


IEEVSTAR 
and 

IEEVMNTI 
IEEVSTAR 


Extended Description 


10 JIEEVMNTt stores ICL related Information, which wes 
Provided with the MOUNT commend, in the SOT. 


IEE VMNT1 end IEEVSTAR both update the CSCB with 
information related to the command perameters. Then, 
before passing control to JEEVJICL, they build e perameter 
list for it. 


After filling in the CSCB, if processing a system address 
space and the procedure name is “IEESYSAS’’, IEEVSTAR 
overlays the name of the procedure (IEESYSAS) with the 
name of the address space. The name of the address space 
is found in the step name. 


11 JlEEVJCL is the JCL build routine. For each newly 

creeted JCL statement, IEEVJICL gets an 88-byte area 
of storage space called e JCLS. It moves each statement 
Into @ JCLS (job control language string) end chains eech 
JCLS to enother. 


After the JCLS chain is done, IEEVJICL issues a GETMAIN 
macro instruction for space for the JSXL. It places these 
pointers in the SEL: 


e A pointer to the JISXL. 
e A pointer to the JCLS chain. 
@ A pointer to the CSCB. 
e A pointer to the ASCB. 


IEEVJCL issues another GETMAIN macro instruction, this 
thme for the JSOL, which is initialized with the commend’s 
jobname, EXEC nama, and procedure name. 


IEEVJCL completes processing by freeing the SDT and 
invoking tha job scheduling subroutine, [IEESBB06. 


Module 
(IEEVMNT?1 


1EEVMNT1 
end 
IEEVSTAR 


(EEVJCL 
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Determine whether 9 subsystem 
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Output 
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Diagram 74. Started Task Control Processing Part 8 of 10 


Extended Description Module Label 


12 (tEESBGOS creates the environment needed for IEESB605 
initiator processing. It begins by obtaining storage 

space for its own work area, called the job scheduling 

work area {JSWA). 


13 JEESB605 creates its own ESTAE environment. It IEESB605 
builds an ESTAE parameter list and issues the ESTAE 

macro instruction, then loads IEESB670, its own recovery 

exit routine. Then, if an error occurs in |EES8605, the RTM 

routines will receive control and, afte: preliminary process- 

ing, Pass control on to [EESB670. 


If RTM provides an SDWA containing the necessary data, (EESB670 
IEESB670 will schedule a retry of (EESBG6O5 that terminates 

current STC processing by issuing a SETRP macro 

instruction. 


If no SOWA exists, IEESB670 will continue ABEND 
processing. 


In either case, the recovery routine will record the error in 
the SYS1.LOGREC data set and return to RTM. 


14 JtEESBEOS builds an SSOB to represent the command! IEESB605 
as a job. It places, in the JSWA, en SSOB pointer and 
an indicator that the SSOB exists. 


15 !EESBG0S also builds an SSIB for the command and 
places pointers to it in tha current JSCB and the 
SSOB. 


Extended Description Module Label 


16  (ltEESBGOS determines whether a subsystem is being 
started by issuing the |EFSSREQ macro Instruction 

to invoke the master subsystem. When the master subsystem 

returns control, IEESB605 checks the return code in 

register 15. 


lf STC is starting a subsystem that can provide its own 
sysout services, [EESB605 places a pointer to the JCLS 
chain in the SSIB (SSIBSUSE). This will allow the master 
subsystem access to the JCLS; otherwise STC treats the task 
as a non-subsystem. 


Norte: In the event of a primary subsystem manual start 
at IPL, any START commands entered prior to starting 
the primary subsystem will result in the started task(s! 
waiting for the STC resource. After the primary 
subsystern is initialized and the STC resource becomes 
available, the primary subsystem starts and the waiting 
task(s) are executed. 


17 If the operator requests that STC use a particular 

subsystem to receive the JCLS, |EESB605 issues 
IEFSSREQ to validate the subsystem, IEESB605 checks 
the return code in register 15. If the subsystem is valid, 
|EESB605 places its name in the SS!B (SSIBSSNM). 
Otherwise, it issues message JEE825|, |EE826l, or IEE82/7I, 
depending on the error. 


If no subsystem was requested, |EESB605 places the name 
of the job entry subsystem in SSIBSSNM. 
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lise (IEL). 
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ASCB 
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ASCBCSCB 
_ 










23 After initiator processing, 
delete ‘the STC SWA structure. 


24 If necessary, delete the CSCB. 





Return to region control 
‘task (1EAVAROO) 
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Diagram 74. Started Task Control Processing Part 10 of 10 


Extended Description Module Label 


18 When STC Is not sterting s subsystem, IEESB60S5 IEF JSWT 
calls IEF JSWT, STC’s internel JCL write routine. 

(\EF ISWT first Initializes e request perarmeter list (RPL) and 

en access control block (ACB), the contro! blocks essoclated 

with the systern dete set into which the JCLS will be 


written. 


{EF ISWT checks en Indicator in the CSCB to determine 
which command is In progress. For a LOGON, the system 
data set used is TSOINRDR:; for the other commends, it 

is STCINROR. For every command, IEF JSWT opens the 
appropriete date set and writes each JCLS record into it. 
When the writing is done, IEF JSWT returns to JEESBG605. 


(EESB605 
iEESB601 


19 JEESBG6OS cleers aff the existing JCLS pointers end 
then cells the STC SWA initlalization routine, 
JEESB601. This Initiellzation routine buitds a skeletal SWA 
structure in preparation for Initiator processing. The SWA 

structure includes these control blocks: 


e JSCB. 

@ OQMPA (queue menager parameter area). 
eo JCT. 

@ ACT 

eScT. 

@ ACT. 

eTIOT. 


20 | EESB605 branches to the PER monitor routine IEAVTJBN 
(IEAVTJBN) to determine if PER should update 


the monitoring status for the address space. 


c 


Extended Description 


21 Once the SWA structure is complete, IEESB601 
returns control to IEESB605, which Initielizes an 
Initietor entrance list (EL) with the following Information: 


@ Options from the JSOL. 

e A polnter to the JSEL. 

e A pointer to tha initiatar option Jist. 
@ A pointer to the Initiator exit list. 


22 ‘'EESB6OS clears pointers to the JSOL, which Is no 
longer needed, end then Issues e LINK macro Instruc- 
tlon invoking en Initletor subroutine, IEFSD060. From thet 
routine, initietor processing proceeds normally until the 
commend task has been executed and Is In terminetion. 
At that point, |EESB605 agaln receives control. (During 
Initlator processing of e MOUNT commend, the Initietor 
ATTACH routine, IEFSD263, attaches IEEVMNT 2, the 
MOUNT command processor. (EE VMNT2 returns control 
to IEFSD263.) 


23. ~=IEES8606 performs STC clean-up functions by free- 

Ing the IEL, the JSWA, end the SSIB and SSOB. It 
Invokes JIEESB601 once again, this tima to delete the SWA 
structure it previously created. When control returns to 
fEESBG6OS, It issues an XCTL macro instruction to 
IEEPRTNZ2. 


24 = The STC free region routine, IEEPRTN2, does not 

free storage space but simply checks for the existence 
of CSCB in the ASCB and frees it if it still exists. 
fEEPRTN2 returns to region control task. 


Module 


(EESB605 


(EFSDO60 


(EESB605 


IEEPRTN2 


Label 
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Diagram 75. Master Scheduler Initialization (IEEVIPL, IEEMB860) Part 2 of 14 


Extended Description Module Label 


Master scheduler initialization, invoked from the NIP mod- 
ule IEAVNIPX, is the final phase of system initialization. 
Following this phase of its initialization, the system is 
ready to receive work in the form of user jobs and com- 
mands from the console. 


Besides initializing parts of the system, master scheduler 
initialization attaches the permanent tasks that run in the 
master scheduler's region. It also invokes routines that 
write initialization records in an SMF data set and in 
SYS1.LOGREC. 


1 In this step, IEEVIPL creates the contro! blocks IEEVIPL 
that the initiator, which will attach IEEMB860, 

uses. IEEVIPL places the master scheduler’s CSCB 

at the beginning of the CSCB chain. 


2  IEEVIPL locates entry points for each of the follow- IEEVIPL 
ing modules via the LOAD macro instruction. For more 

information on these modules, refer to the publication 

System Logic Library. 


@ The system-initiated cancel (SIC) routine-schedules the 
orderly cancellation of a time-sharing user when requested 
to do so by the operator or when forced to do so by a 
disconnected telecommunications line. 


@ The resource management routine — including 
initiator resource management. 


C 


Extended Description 


e The master trace service routines — include: 


- The |EEMB808 data entry routine whose address 
is stored in field BAMTRATN. 


- The 1EEMB809 create/deactivate master trace 
table routine whose address is stored in BAMTCDR. 


Module 


C 


Label 
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Diagram 75. Master Scheduler Initialization (IEEVIPL, IEEMB860) Part 3 of 14 
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Diagram 75. Master Scheduler Initialization (IEEVIPL, IEEMB860) Part 4 of 14 


Extended Description Module Label 


3 Master scheduler initialization determines if a master 
trace table was requested during system initialization. 
lf so, it obtains the required size from field BAMTINIT in 
the master scheduler resident data area (MSRDA). It issues 
the IEETRACE macro to initialize the master trace table. 


if the master trace table initialization fails, module 
IEEVIPL issues message [EE840I. 


4 Communications task initialization prepares the system 

operator consoles for sending and receiving data. This 
initialization includes creating and initializing the communi- 
cations task address space, initializing the task by setting up IEAVN700 
the communication task control blocks and environment, IEAVVINT 
and initializing DIDOCS, For more detail, refer to Diagrams IEECVGCI 
64, 65, 66 and 67. 


F \EEVIPL uses the event notification facility (ENF) 
routine, IEFENF XX, to signal that the initialization 
of the communications task is complete. 


6 Subsystem interface initialization creates the control IEFJSINT 
blocks to be used by the subsystem interface to 

determine which subsystem routine is to receive control 

following a request. Initialization builds a subsystem CVTs 

(SSCVTs) for the subsystem specified on the SCHEDULR 

sysgen macro and in IEFJSSNT. Then initialization builds 

the subsystem vector table for the master subsystem. For 

more detail, refer to Diagrams 68 and 69. 


7 =IEEVIPL calls IEFQBINT to initialize the SWA manager. IEFQBINT 


8  JIEEVIPL invokes the allocation initialization routine, IEFAB4I0 
|IEAFAB4IO, to: 
@ Store allocation entry points in the JESCT and CVT 
e Load the EDT and store its address in the JESCT 
(JESCDT) 
@ Build the UCB pointer list (UPL) 
@ Invoke the EDT verification routine (1EFEB400) 
@ Create and initialize the allocation address space 
(ALLOCAS) 
If |EFAB410 does not successfully complete the 
initialization of the allocation address space, the recovery 
routine, |EFAB4E6, indicates the failure in the JESCT IEFAB4E6 


(JESUASR=0) and issues message number IEF1001. 
IEFAB4I0 then returns to IEEVIPL with a return code of 
4. IEEVIPL continues with the system initialization. 


If IEFAB4I0 loads an invalid EDT, JEFABIO invokes 
IGFPTERM to issue message |EF9271 or message |EF928I 
and places the system in a wait state with a code of X‘400’. 


Extended Description Module Label 


Q Thecontrol blocks created in step 1 above (IEL, JSCB, IEFSDO60 
CSCB, and SS|B) are used by the initiator, which, via 

the subsystem interface, requests job selection from the 

master subsystem. The master subsystem serves as a substi- 

tute for the job entry subsystem, which has not yet been 

initialized. Figure 4-8 portrays the initiation process for 

the master scheduler. The system initialization routine, 

IEF JJOBS obtains the master JCL suffix value from the 

scheduler NIP parameter list (/EEZB807) and appends it 

to MSTJCL to form a member name. The master subsystem 

obtains the JCL card images from the MSTJCLxx member 

of SYS1.LINKLIB. The MSTJCLOO member contains the 


following: 
//MSTJCLOO JOB MSGLEVEL=(0,0) 
[i EXEC PGM=IEEMB860,DPRTY=(15,15) 


//STCINRDR DD SYSOUTS=(A,|INTRDR) 

//TSOINRDR DD SYSOUT=(A,INTRDR) 

//JEFPDS!| DD DSN=SYS1.PROCLIB,DISP=SHR 
///IEFPARM DD DSN=SYS1.PARMLIB,DISP=SHR 
//SYSUADS DD DSN=SYS1.UADS,DISP=SHR 
//SYSLBC DD DSN=SYS1.BRODCAST,DISP=SHR 
//START &SSNAME 

/* 

The symbolic name, &SSNAME, is replaced by the name 
given to the job entry subsystem at system generation 
time. With MSTJCLxx as input, the converter and 
interpreter create first internal text then SWA control 
blocks. The EXEC statement of this JCL causes execution 
of |EEMB860, which continues the master scheduler 
initialization function. The DD statements permit allocation 
of TSO data sets and other system data sets required by 
those tasks that execute in the master scheduler region. 
The START command causes a CSCB to be created which, 
when processed by the master scheduler wait, will start 
the job entry subsystem (for example, JES2). 


The function of the initiator is described in detail in the 
Publication System Logic Library. 
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Diagram 75. Master Scheduler Initialization (IEEVIPL, IEEMBS860) Part 5 of 14 
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Diagram 75. Master Scheduler Initialization (IEEVIPL, IEEMB860) Part 6 of 14 


Extended Description Module Label! 


10 ~The initiator fills in the JSCB, which is located in 
the master scheduler’s local system queue area 
(LSQA). After being attached by the initiator, |EEMB860 


moves this JSCB into the common service area (CSA). 
Normally, a task leaves its JSCB in the LSQA., 


|IEEMB860 


11 |EEMB860 attaches the Comm Task Command Initial- 
ization Routine (IEAVC701) and waits for it to com- 
plete. 


12 |EEMB860 calls the scheduler JCL facility routine, 

|EFSJINT, to create the default JCL definition 
vector table (JDVT). See System Logic Library for a 
description of IEFSJINT. 


13 The TSO module IKJEF XSR invokes the link-pack- 
area search routine (IEAVVMSR) to obtain the 
addresses of certain I/O service routines used by TSO com- 
mand processors. Upon return from IEAVVMSR, register 0 
points to an LPDE (link pack directory entry). This direc- 
tory entry contains the entry point address of the routine it 


IKJEFXSR BUILD 


located. IEAVVMSR is invoked for each routine name that 
is coded in IKJEFXSR: 


IKJGETL — Get-line routine 

IKJPUTL — Put-line routine 

IKJPTGT — Put-get routine 

IKJSTCK — Stack routine 

IKJSCAN — Command scan routine 

IKJPARS — Parse routine 

IKJDAIR — Dynamic allocation interface routine 
IK. JEHDEF — Default routine 

IKJEHCIR — Catalog information routine 


Extended Description Module Label 


As the routines are located, IKJEF XSR places their entry 
point addresses in the CVT and turns on the high-order bit 
in each CVT field containing an entry point address. To 
obtain the CVT field name corresponding to a routine, 
IKJEFXSR replaces the first three characters (‘IKJ’) of the 
routine name with the characters ‘CVT’. 


lf the search routine cannot find an |/O service routine in 
the link pack area, IKJEF XSR continues processing with 
the next routine name. It leaves the high-order bit off in 
the CVT field for the routine not found. 


When a TSO command processor issues the CALLTSSR 
macro instruction, it specifies the module name of the |/O 
service routine it is invoking. The macro instruction checks 
the high-order bit of the corresponding CVT field. If it is 
on, CALLTSSR branches to the address specified in the 
corresponding CVT field. If it is off, CALLTSSR issues a 
LINK macro instruction for the module name requested. 

If TSO/E Release 2 or later is installed, IKJEFXSR builds 
the TSO vector table (TSVT) and initializes it with the 
addresses of additional TSO service routines. The initial- 
ization process is the same as described for initializing the 
CVT fields. 


Recovery Processing 

If IKJEFXSR abnormally terminates, its EST AE routine, 
after issuing a message, passes control back to master 
scheduler initialization (IEEVIPL). IEEVIPL continue: 
with system initialization and does not terminate. 


IKJEFXSR XSRRETRY 


14 |IEEMB860 attaches the ENF wait routine 
(IEFENFWT), which completes ENF initialization. 

ENF can now process all requests for service. (See 

System Logic Library, for a description of IEFENFWT.) 
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Diagram 75. Master Scheduler Initialization (IEEVIPL, IEEMB860) Part 8 of 14 


Extended Description 


15 |EEMB860 attaches the SMF create router (IEEMB820) 


to start processing to create the SMF address space 
via the system address space initialization. 


16 IEEM B860 attaches the missing interrupt handler 

(MIH}, which initializes itself by determining the 
time intervals at which it checks for missing interruptions. 
A complete description of MIH logic is in System Logic 
Library. 


17 |'&EMB860 attaches the IPL/outage recorder to write 
the initialization record to SY$1.LOGREC via 

SVC 76. This record contains the time and date of the IPL, 

the processor model and serial number, a code indicating 

the reason for the IPL, channel information, and the 

highest real storage address. 


18 The NIP module (IEAVNP13 has already read 

|EACMDOO and COMMNDxx members of 
SYS1.PARMLIB containing the automatic commands), 
copied the commands into storage, and placed a pointer to 
the commands in field SNPCMD of the scheduler NIP 
parameter list (IEEZB807). Master scheduler initialization 
internally issues each of these commands via SVC 34, and 
then frees the space taken up by the commands. 


19 Recovery termination management (RTM) initial- 

ization attaches three permanent tasks: the first 
processes asynchronous recording requests, the second 
schedules SVC dumps for the master scheduler’s address 
space, and the third processes requests for address space 
termination. 
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Diagram 75. Master Scheduler Initialization (IEEVIPL, IEEMB860) Part 9 of 14 
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Diagram 75. Master Scheduler Initialization IEEVIPL, IEEMB860) Part 10 of 14 


Extended Description Module Label 


20 ‘Because SMF initialization is an attached task, it runs |EEMB860 
in parallel with master scheduler initialization. 

Master scheduler initialization waits for completion of 

the SMF address space to be sure that SMF is ready to 

record before the system begins processing jobs. 


21 IOSVIOSI calls IECVDPTH to initialize all online iOSVIOSI 
devices with the dynamic pathing feature. It 

also calls IOSVSMEI to establish IOSVSMGR as an event 

notification (ENF) listener for event code 4. (See System 

Logic Library for more details about dynamic pathing 

initialization and the |OS storage manager.) 


22 ‘If the mass storage system communicator (MSSC) !EEMB860 
has been included during system generation, and 

the MSSC RIM has processed successfully, control is 

passed via the LINK macro to the MSSC initialization 

module (ICBINIT). For more information, refer to 

Mass Storage System Communicator Logic. 


23. ~=3=Attach the ASM task mode initialization routine, ILRTMRLG 
ILRTMRLG and wait for it to complete. Module 

ILRTMRLG calls ILRTMIOO to complete ASM initializa- ILRTMIOO 

tion. 
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Diagram 75. Master Scheduler Initialization (IEEVIPL, IEEMB860) Part 11 of 14 












Attach security initialization 
routine. 


Invoke subsystem initialization. 
IEFJSIN2 


Subsystem 
initialization 






Account for all allocated 
volumes. 








|EFHB412 


Display 
allocation 
scavenger 












Attach the service processor 
initialization routine. 
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Diagram 75. Master Scheduler Initialization (IEEVIPL, IEEMB860) Part 12 of 14 


Extended Description 


24 = =Attach the system security initialization routine 
(ICHSECOO). When it completes processing, 
detach it. 


25 _ ~=—Master scheduler initialization invokes |EFJSIN2 
to initialize the subsystems. 


2G _=|EEMB860 accounts for all allocated by volumes by 

invoking JEFHB412. tEFHB412 examines all UCBs 
and identifies whether or not the volume associated with 
the UCB is allocated. Up to this point in the master 
scheduler initialization process, volumes (such as the IPL 
volume) have been allocated for use by the various 
initialization routines without using the system allocation 
routines. 


}EFHB412 records the allocation status of each UCB in 


display allocation lookup tables (DALTs). When the system 


begins to use the system allocation routines, these DALTs 


serve as the starting status for current allocations. The system 
allocation routines then keep track of future allocation status. 


27 \EEMB860 attaches [EAVSPDM to initialize the 
service processor. 


Module Label 


ICHSECOO 


IEFJSIN2 


(EFHB4I2 


IEAVSPDM 
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Diagram 75. Master Scheduler Initialization (IEEVIPL, IEEMB860) Part 14 of 14 


Extended Description Module Label 


28 _ ~The final portion of master scheduler initialization [EEVWAIT 
runs under the control of the master scheduler wait 

module. First, it enqueues on serialization resources to 

prevent started task control (STC) and TSO LOGON from 

requesting job entry subsystem services before the sub- 


system is initialized: 


@ STC serialization resource — major name SYSIEFSD, 
minor name STCQUE. 

e LOGON serialization resource — major nameSYSIEFSD, 
minor name TSOQUE. 


If step 13 of this diagram processed any START or MOUNT 
commands, started task control (STC), executing on behalf 
of these commands, suspends its processing until the job entry 
subsystem is initialized. STC accomplishes this by enqueuing 
on the STC resource {major name SYSIEFSD, minor name 
STCQUE). 


The wait module scans the CSCB chain for pending com- 
mands. One of the first commands to be processed is the 
one that starts the job entry subsystem. This START com- 
mand is contained in the master scheduler’s JCL, which was 
interpreted before the initiator attached IEEMB860. Atthat 
time, the CSCB for this command was put in the CSCB chain. 
A listing of the master scheduler’s JCL is in the extended 
description for step 10. (The symbolic name, &SSNAME is 
replaced by the four-character name given to the job entry 
subsystem at system generation time.) Figure 4-9 portrays 
the initiation of the job entry subsystem. 


IEEVWAIT 


When processing a ST ART command CSCB for system ad- 
dress space, normal START processing is bypassed and 
{EEVWAIT posts the EAEASWT/CHASWT ECB to inform 
the system address space initialization wait/post routine, 
[IEEMB883, that master scheduler initialization has 
completed, 


After the job entry subsystem is initialized, the wait module 
allows STC and TSO LOGON to process by dequeuing 
from the serialization resources. 


The wait module attaches the system log task after the job IEEMB803 
entry subsystem is initialized. The log task initializes itself 

by setting up the data areas necessary to write in the log data 

set. It verifies the log parameter values from SYS1.PARMLIB 

and stores them in the log control table. The log task notifies 

the system operator if log initialization fails and tells him 


whether or not the log isactive. Thelog is initialized not only 


Extended Description Module Label 


at IPL time, but also in response to aWRITELOG START 
command. A detailed description appears under the topic 
“System Log Initialization” in the command processing 
section of System Logic Library. Once the log task is initial- 
ized, it notifies the communications task. If the hardcopy 
record is assigned to the system !og data set, the communi- 
cations task can Now write the initialization hardcopy record 
in the system log data set. 


Recovery Processing 


IEEVIPLruns under an ESTAE environment which passes JEEVIPL IPSTAR 
control to an exit routine if IEEVIPL fails or abnormally 

terminates. This exit routine performs the following func- 

tions depending on whether the communications task is 


initialized or not: 


e Issue an SVC dump, if necessary. 

e Communications task not initialized: put the system in 
a permanent wait state. 

— Wait state code X’00B’ indicates that a dump was 
taken. 

— Wait state code X’00D’ indicates that a dump was 
not taken. 

e@ Communications task initialized: issue message |EE479W 
to inform the operator of the problem and of the dump 
status (dump taken or not taken) and put only the master 
scheduler task in a wait state. 


IEEMB860 STAEOO 
STAE10 


| EEMB860 also runs under an ESTAE environment. Itsexit 
routine performs functions similar to those of IEEVIPL’s 
exit routine: 


@e Issue an SVC dump, if necessary. 

@ Issue message |EE479W to inform the operator of the 
problem and of the dump status {dump taken or not 
taken). 

@e Put the master scheduler task in a wait state. 


The ESTAE exit routine for IEEVWAIT is completely de- 
scribed in the diagram “Master Scheduler Wait Recovery and 
Retry” in the publication System Logic Library. 
/EEVWAIT's exit routine performs processing and, in certain 
cases, attempts a retry of master scheduler wait. 


IEEVWAIT STAEOOOO 
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Diagram 76. Communications Task Address Space Create (IEAVN700) Part 1 of 2 


From Master Scheduler 
Initialization 


Process 


[IEAVN700 
Communications Task 
Address Space Create 

Routine 


Input 












1 Establish an ESTAE 
environment. 


task address space. 
















Register 2 


EAERIMWT 


3 Wait to be posted by 
the communications 
task address space 

initialization routine. 


4 Delete the recovery 
environment. 





2 Create a communications 


jEEMB881 


System address 
emace create 
routine 


Return to Master 
Scheduler Initialization 





Output 


Register 1. 


Parameter List 


USRATTR 


USRPARMS 


“CONSOLE’ 


“IEAVN701’ 


Register 15 


——— 
EATTLEN 

= = ____— | 
EATTRTYP 

el 
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Diagram 76. Communications Task Address Space Create (IEAVN700) Part 2 of 2 


Extended Description Module Label 
This module invokes system address space initialization to 

create the communications task address space. The module 

waits for the communications task address space to be 


initialized before returning to its caller. 


1 IEAVN700 initializes a user parameter list and IEAVN700 SETESTAE 
issues an ESTAE macro instruction to establish 

ESTAE 700 as the ESTAE exit routine. If the ESTAE is 

not successful, it returns a non-zero return code in 

register 15, and control is passed to ESTAE700. 

2 = Set the attribute list, EATTR to indicate the type of (EEMS8881 

address space to be created (via a link to IEEMB881). 


The attributes are: 


Executable, high priority 

Non-swappable 

Has no special requirements for preferred storage 
Cannot be canceled 

Cannot be forced 

Cannot be terminated 

Wait state is loaded by RTM on DAT error 


In addition, set USRPGMN to point to the name of 
the initialization routine (JEAVN701) and set USRPARMS 
to point to the name of the address space (CONSOLE). 


If IEEMB881 returns a non-zero return code in register 
15, control passes to the recovery routine, ESTAE700O. 


Extended Description 


3 During its processing, |EEMB881 invokes the 

memory creation process and passes control to started 
task control processing (IEEPRWI2). Started task control 
processing in turn passes control to the communications task 
address space initialization routine (IEAVN701). IEAVN701 
uses the EAERIMWT field to issue a cross memory post for 
IEAVN700. 


4 Cancel the ESTAE environment and return to the 
caller. 


Recovary Processing 


The recovery routine (ESTAE700): 


e Establishes addressability using the registers saved in 
the user parameter list 

e If aSDWA exists, records the appropriate diagnostic 
information in the variable recording area of the 
SDWA 

e@ Obtains the local lock, takes an SDUMP, and releases 
the loca! lock 

@ Requests a retry 


The retry routine calls IGFPTERM to: 


@ Issue message IEA366W to an active console 

@ Write a record in SYS1.LOGREC 

@® Terminate the initialization process with a X‘201’ 
wait state 


Module Label 
IEEPRWI2 


[EAVN701 


IEAVN700 ESTAE700 


IEAVN700 RETRY700 
IGFPTERM 
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Diagram 77. Communications Task Address Space Initialization (IEAVN701) Part 1 of 4 


Link from 1EEPRWI2 
input Process Output 
IEAVN701 
Communications Task 
Address Space 
Initialization Routine 









Register 15 


Register 1 


1 Establish an ESTAE 
environment. 





UCM base 







Save address space infor- 
mation in the unit 
control module (UCM) 
and the command address 
scheduling table (CAST). 





4 ascB 
4 EcBS 
* |EEMB883 








3 Establish a cross memory 
environment. 
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Diagram 77. Communications Task Address Space Initialization (IEAVN701) Part 2 of 4 


Extended Description Module Label 


This module initializes the communications task address 
space as follows: 


e Sets up across memory environment 

e Calls the communications task initialization routine 
(IEAVVINT) 

e Attaches the various tasks for communications task 
processing 

e Initializes the action message retention facility 


1 JEAVN70Q1 initializes a user parameter list and issues IEAVN701 SETESTAE 
an ESTAE macro instruction to establish ESTAE701 

as the ESTAE exit routine. If the ESTAE is not successful, 

it returns a non-zero return code in register 15, and control 

is passed to ESTAE700. 


2  ‘EAVN701 stores the ASCB address and the ASID TOP 
in the respective unit contro! module (UCM) fields 

UCMASCB and UCMCTID. It also stores the ASCB address 

in the communications task entry of the command address 

scheduling table (CAST). If it cannot update the CAST, 

it sets an error condition and passes control to the 

recovery routine, ESTAE701. 


3  ‘IEAVN70(1 sets the program call authorization SETXMEM 
index to 1 and constructs and connects an entry 
table for the WQE service routine (IEAVH600). 
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Diagram 77. Communications Task Address Space Initialization (IEAVN701) Part 3 of 4 


Input 


UCMAMRFC 


UCMPUXIT 








4 Attach IEAVN702. 


Process 


5B tnitialize the communications 
task control! blocks. 


G Inform 1EAVN700 that 
communications task 
address space is 
created. 


J Determine whether to acti- 
vate or deactivate the action 
message retention facility 
and the general WTO user 
exit. 


8 Attach communications 
task functional subtasks 
and wait for tasks to 
complete. 


Q Issue ENF signal for avail- 
able MCS buffers. 








tEAVN702 


Communications 
task initialization 
cleanup 


IEAVVINT 


Communications 
task initialization 





Output 


UCM extension 


Command Image 


‘CONTROL M, AMRF=Y,UEXIT=Y' 
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Diagram 77. Communications Task Address Space Initialization (IEAVN701) Part 4 of 4 
Extended Description Module Label 


4 JEAVN701 attaches the communications task address IEAVN702 
space initialization cleanup routine (IEAVN702) 

passing it the address of the system address space initialization 

WAIT/POST routine (IEEMB883). [IEAVN702 invokes 

|EEMB8883 and waits for master scheduler initialization 

to complete. 


5 IEAVN701 links to the communications task IEAVVINT 
initialization routine (IEAVVINT). [IEAVVINT 

initializes the communications task’s control blocks, creates 

the allocation control blocks required to open all the consoles, 

and determines the entry points of the modules the 

communications task uses. 


6 Upon successful initialization of the address space, 
IEAVN701 issues a cross memory post to IEAVN700 

by means of EAERIMWT. If the post is not successful, 

control passes to the recovery routine, ESTAE701. 


7 _—IEAVN701 issues an internal command to activate or EAVN701 AMREINIT 
deactivate the action message retention facility and to 

activate or deactivate the user exit (IEAVMXIT) based on 

UCMAMREC and UCMPUXIT fields in the UCM base. The 

fields are set according to the AMRF and UEXIT options in 

the CONSOLxx SYS1.PARMLIB member. 


8 IEAVN701 attaches IEAVMQWR, the communications 
task wait and router routine, and IEEVWAIT, the 
command scheduler wait routine. IEAVN701 waits for ISSWAIT 
each task to complete. If a task fails, IEAVN701 detaches the 
failing TCB and also clears the corresponding ECB. If 


IEAVMQWAR fails, IEAVN70Q1 re-attaches it. If IEEVWAIT VMQWREND 
fails, and an external restart for IEEVWAIT is not in process, 
IEAVN701 re-attaches IEEVWAIT. If an external restart VWAITEND 


is in progress, IEAVN70O1 does not re-attach IEEVWAIT; 
instead it issues message IEE365E. 


QQ iIf the IEAVMQUR Communication Task subtask has 

ended, IEAVN701 check bit UCMSDS1D in the UCM 
prefix. If UCMSCS1D is zero, meaning that MCS buffers 
are available, IEAVN70O1 issues an asynchronous ENF 
signal with an event code of ENFPCO113 and a qualifier 
code of ‘00000002’. 


Extended Description 


Recovery Processing 


The recovery routine (ESTAE701): 


e Ifa SOWA exists, records the appropriate diagnostic 
information in the variable recording area of the SOWA 

e Obtains the local lock, takes an SDUMP, and releases 
the local lock 

e@ Requests a retry 


The retry routine (RETRY701) calls IEEVLOWT. 
[IEEVLOWT issues message 1EA367A if the master console 
on its alternate is an active display console, or loads a 
restartable wait state code of X’202.’ 


The retry routine then waits on an ECB that is never 
posted and thus allows the system to continue processing 
even though the communications task is not functioning. 


Module 


IAAVN701 
IEEVLOWT 


Label 


ESTAE701 


RETRY 701 
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Diagram 78. Communications Task Address Space Initialization Cleanup (IEAVYN702) Part 1 of 2 
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Task Address Space 
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Input 
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address space 
initialization 

cleanup 
1EAVN702 


Register 1 
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4 Set control block pointers 
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processing. 
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Diagram 78. Communications Task Address Space Initialization Cleanup (IEAVN702) Part 2 of 2 


Extended Description Module Label 


The communications task initialization cleanup routine 
(1EAVN702) is called by [EAVN701. 


1 ‘EAVN702 creates a two-word parameter list, pointed IEAVN702 
to by register 1, that it passes to the system address 

space initialization WAIT /POST routine (IEEMB883). The 

first word contains the address of the communications task 

address space ASCB; the second word contains the address 

of the master scheduler event code. 


1EAVN701 calls IEEMB883 to wait for master scheduler 1IEEMB883 
initialization to complete. On return from [EEMB883, 

control returns to the dispatcher, by means of SVC EXIT 

(SVC 3). 
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Diagram 79. Communications Task Initialization TEAVVINT) Part 1 of 21 


ITEAVVINT - MODULE DESCRIPTION 


DESCRIPTIVE NAME: COMMUNICATIONS TASK INITIALIZATION ROUTINE 


FUNCTION: 
IEAVVINT BUILDS THE VARIOUS ALLOCATION CONTROL BLOCKS 

NEEDED BY OPEN (DSAB;, QDB, AND TIOT), INITIALIZES THE VARIOUS 
ADDRESS FIELDS IN THE SYSTEM (CVT, JSCB, SCVT, AND 
TCB}, NOTIFIES COMTASK IF SYSLOG IS NOT THE HARDCOPY DEVICE, 
SETS UP THE INITIAL CELL POOLS FOR THE WQE'S, ORE'S, AND 
CQE'S. ACQUIRES AND INITIALIZES THE UCM FIXED AND PAGEABLE 
EXTENSION BASES AND THE FIXED AND PAGEABLE UCME 
EXTENSIONS. IT BUILDS A SUBSYSTEM INTERFACE BLOCK(SSIB) 
FOR COMTASK, GETMAINS AND INITIALIZES A WORK AREA FOR 
COMTASK 'S USAGE OF MASTER TRACE AND GETMAINS A WORK AREA 
FOR IEAVH600. IT ALSO INITIALIZES THE CONSOLE ENTRY OF 
THE ATTENTION TABLE TO CONTAIN THE COMM TASK ADDRESS 
SPACE ASID,» 
AND FASSES CONTROL TO THE DIDOCS (DISPLAY CONSOLE SUPPORT ) 
INITIALIZATION ROUTINE. 


ENTRY POINT: IEAVVINT 


PURPOSE : 
ENTERED WITH PROTECT KEY ZERO AND SUPERVISOR STATE 
DURING COMM TASK INITIALIZATION TIME TO INITIALIZE 
THE COMMUNICATION TASK'S CONTROL BLOCKS. 


LINKAGE: 
LINKED TO-- LINK EP=IEAVVINT 
ONLY CALLER IS COMMUNICATION TASK ADDRESS SPACE 
INITIALIZATION, IEAVN701. 


CALLERS: None 
INPUT: 


AS FOLLOWS: 
CVTCUCB = ADDRESS OF UCM 


REG 13 = ADDRESS OF A REGISTER SAVE AREA 
REG 14 = RETURN ADDRESS 
REG 15 = ENTRY POINT ADDRESS 


OUTPUT: UPDATED COMM TASK CONTROL BLOCKS. 
EXIT NORMAL: VINTEXIT 
OUTPUT: 


THE FOLLOWING CONTROL BLOCKS HAVE FIELDS 
WHICH ARE INITIALIZED BY THIS MODULE: 


DSAB SCVT 

JSCB TCB 
TIOT 

QDB SSIB 
UCM 
GENX 


NOTE: THE DSAB‘'S, TIOT, AND QDB 
ARE CREATED BY THIS MODULE 


EXTERNAL REFERENCES: 


ROUTINES: IEECVGCI, TO INITIALIZE FOR DIDOCS. 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 2 of 21 


CONTROL BLOCKS: 


AMRQ 


KEY = R-READ, C-CREATE, W-WRITE 


TABLES: 
SEE DESCRIPTION ABOVE. 


IEZMTPRM, IEETRACE PARMLIST MAPPING MACRO 
ATTENTION TABLE, ENTRIES MAPPED BY IECDATB 


SERIALIZATION: 


THE LOCAL LOCK IS OBTAINED 


AS FOLLOWS: 


MAPPING MACRO 


ITHACTM 
IHAASVT 
IHACTM 
ITHACVT 
IHADSAB 
IHAHCLOG 
IECOCIOM 
IEZJSCB 
ITHAORE 
IHAPSA 
ITHAQDB 
IHASCVT 
IEFJSSIB 
IKJTCB 
ITEFTIOTI 
IEFUCBOB 
IEECUCM 
THAWQE 


BRANCH ENTRY TO GETMAIN. 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 3 of 21 


IEAVVINT - MODULE OPERATION 





THIS MODULE BEGINS BY BUILDING THE CONTROL BLOCK 


CHAIN OF DSAB'S AND TIOT DD ENTRIES THAT WILL LATER BE USED 
WHEN THE CONSOLE DEVICES ARE 

OPENED. THE STORAGE FOR THE DSAB'S, QDB;, AND TIOT ARE GOTTEN 
FROM SP 230. A BRANCH ENTRY TO GETMAIN IS USED TO OBTAIN 
THE STORAGE IN THE SCHEDULER'S STORAGE PROTECT KEY (LOCAL 
LOCK IS HELD ACROSS THIS GETMAIN) SO THE BLOCKS WILL HAVE THE 
SAME KEY AS THEY WOULD BE IF BUILT BY THE SCHEDULER. 

THE AMOUNT OF STORAGE TO BE GOTTEN IS CALCULATED FROM THE 
NUMBER OF CONSOLES IN THE SYSTEM. 

WHEN THE COMPLETE CHAIN IS BUILT; 

THE ADDRESS OF THE QDB IS PLACED IN THE JFCB 

AND THE ADDRESS OF THE TIOT IN THIS 

TASK'S TCB. 


AN SSIB IS BUILT FROM STORAGE OBTAINED FROM SP 241, AND 
THE BLOCK IS QUEVED OFF THE JSCB AND THE UCM. 


THE MODULE NEXT USES THE LOAD MACRO TO RESOLVE ADDRESSES OF 
ROUTINES IN LPA AND LINKLIB. ENTRY POINT ADDRESSES ARE 
PLACED IN THE SCVT AND UCM. AFTER THE ENTRY POINTS 

ARE RESOLVED, DELETE’S ARE ISSUED FOR THE LPA ROUTINES. 


NEXT, THE CELL POOLS FOR WQE'S, ORE’S, AND CQE'S ARE 
BUILT. THE WQE AND CQ@E STORAGE SIZE IS DETERMINED BY THE 
NUMBER OF SYSGENED CONSOLES. (THE MINIMUM-MAXIMUM NUMBER 
OF WQ@ES IS 20-2000.(20 IS THE WTOBUF MINIMUM LIMIT. ) 

THE MINIMUM-MAXIMUM NUMBER OF CQES IS 10-295). 

THE STORAGE FOR THE ORE'S IS OBTAINED FROM ABOVE 16 MB. 





THE ECB LIST THAT IEAVMQWR 

WAITS ON IN A NO-CONSOLES CONDITION IS INITIALIZED. 
THE COMM TASK ENF LISTEN EXIT ROUTINE(IEAVG600) IS 
LOADED AND THE ADDRESS STORED IN THE FIXED EXTENSION. 


CALCULATE 60 AND 80 PERCENT VALUES OF THE ORE LIMIT 
SPECIFIED AT PARMLIB MEMBER CONSOLXX. 

STORE THESE NUMBERS IN UCMF60OR AND UCMFS8OOR. 

CALCULATE 60, 80, AND 95 PERCENT VALUES OF THE WQE 

LIMIT SPECIFIED IN PARMLIB MEMBER CONSOLXX. 

STORE THESE NUMBERS IN UCMF60WQ, UCMF8OWNQ, AND UCMF9SWQ, 
THESE FIELDS ARE IN THE UCM FIXED EXTENSION BASE. 


CALCULATE 75, 80 AND 95 VALUES OF THE NUMBER OF 
MESSAGES WHICH CAN BE RETAINED BY THE ACTION MESSAGE 
RETENTION FACILITY AND STORE THEM IN THE UCM FIXED 
EXTENSION BASE. 


ISSUE GETMAIN TO OBTAIN A WORK AREA FROM SUBPOOL 229, 
TO BE USED BY IEAVH600. THE ADDRESS IS SAVED IN 
UCMNGQADA. 


ISSUE GETMAIN TO OBTAIN A WORK AREA FROM SUBPOOL 229, 
TO BE USED BY IEAVM601. THE ADDRESS IS SAVED IN 
UCMFHCDA. 


INITIALIZE THE CONSOLE ENTRY OF THE ATTENTION TABLE 
TO CONTAIN THE COMM TASK ADDRESS SPACE (CTAS) ASID. 


IF SYSLOG IS NOT THE HARDCOPY DEVICE, FIELD UCMNPECB IN 
UCM IS POSTED. 


NEXT TEST FOR WHETHER DISPLAY CONSOLES ARE 
PRESENT, AND, IF SO LINK TO THE DIDOCS INITIALIZATION 
ROUTINE. 
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Diagram 79. Communications Task Initialization IEAVVINT) Part 4 of 21 
IEAWINT - DIAGNOSTIC AIDS 

ENTRY POINT NAME: IEAVVINT 

MESSAGES: None 

ABEND CODES: None 

WAIT STATE CODES: None 

RETURN CODES: None 

REGISTER CONTENTS ON ENTRY: Irrelevant 


REGISTER CONTENTS ON EXIT: Irrelevant 
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Diagram 79. Communications Task Initialization (EAVVINT) Part 5 of 21 


IEAVVINT - COMMUNICATIONS TASK INITIALIZATION ROUTINE STEP 012 





N IEAVVINT BUILDS THE VARIOUS ALLOCATION CONTROL BLOCKS 
>| |NEEDED BY OPEN (DSAB, QDB, AND TIOT), INITIALIZES THE 
/ ||VARIOUS ADDRESS FIELDS IN THE SYSTEM (CVT, JSCB, 
ITEAVVINT| |SCVT, AND TCB), NOTIFIES COMTASK IF SYSLOG IS NOT THE 
HARDCOPY DEVICE, SETS UP THE INITIAL CELL POOLS FOR 
THE WQE'S, ORE'S, AND CQE'S. ACQUIRES AND INITIALIZES 
THE UCM FIXED AND PAGEABLE EXTENSION BASES AND THE 
FIXED AND PAGEABLE UCME EXTENSIONS. IT BUILDS A 
SUBSYSTEM INTERFACE BLOCK(SSIB) FOR COMTASK, GETMAINS 
AND INITIALIZES A WORK AREA FOR COMTASK'S USAGE OF 
MASTER TRACE AND GETMAINS A WORK AREA FOR IEAVH600. 
IT ALSO INITIALIZES THE CONSOLE ENTRY OF THE 
ATTENTION TABLE TO CONTAIN THE COMM TASK ADDRESS 
SPACE ASID, AND PASSES CONTROL TO THE DIDOCS (DISPLAY 
CONSOLE SUPPORT) INITIALIZATION ROUTINE. 


or UCMEXTBD (A) APPROX. 079070 WQE THRESHOLD A {LOAD 

AND DELETE AREA) A (UCMEXTBD) D (PATCH) C 
(GETSPACE - SAVE REGS WHEN OBTAINING LOCKS) C 
(GETSPACE - SAVE REGS WHEN OBTAINING LOCKS) A 
(LOAD AND DELETE IEAVM700) C (GETSPACE - SAVE 
REGS WHERE LOCKS ARE HELD) D (IEAVVINT) INIT OF 
UCMCTID AND UCMASCB DELETED A (WTOSTOR) OBTAIN 
STORAGE FOR IEAVH600'S WORK AREA A BLDCPOOL FOR 
CQ@ES FROM COMM TASK PRIVATE C BLDCPOOL FOR WGES 
TO GET STORAGE FROM COMM TASK PRIVATE A 
(LOADMODS) DELETE IEAVMFRR AND IEAVMEST AFTER 
LOAD C (UCMEXTBD) DON'T SET ACR ECB ADDRESS A 
(END) INITIALIZE COMM TASK ASID IN I/O ATTENTION 
TABLE D (UCMEXTBD) BUILD UCME PAGEABLE EXTENSION 
C (DECLARES) ADJUST AMRMINRM FOR NEW AMRQ SIZE C 
(BLDSSIB) CHANGE COMM TASK LIFE OF JOB SSIB FROM 
SUBPOOL 255 TO 241 A (UCMEXTBD) INITIALIZATION OF 
MESSAGE LEVEL A (L°ADEXIT) LOAD THE GENERAL WTO 
USER EXIT (TEAVMX1\) A (GETWORK) ENLARGE THE 
IEETRACE WORK AREA A (LOADMODS) LOAD, SAVE THE 
ADDRESS AND DELETE IEECVXIT D {LOADMODS) DELETE 
LOAD/DELETE FOR IEAVMNQR AND IEECMEN@Q D 
(LOADMODS) DELETE THE DELETE FOR IEAVSWCH D 
(CONSOLCB) DELETE THE DELETE FOR DEVICE SERVICE 
PROCESSORS D €LOADEXIT) REMOVE LOAD OF IEAVMXIT C 
(UCMEXTBD) LOAD AND DELETE COMM TASK ENF LISTEN 
EXIT (IEAVG600). CALCULATE 95 

OF THE IPL SPECIFIED WQE LIMIT. ( (CELLPOOL ) 
ISSUE GETMAIN TO OBTAIN ORE CELLPOOL C (UCMEXTBD ) 
REMOVE GETMAIN FOR UCM FIXED EXTENSION BASE, UCME 
FIXED EXTENSION, UCM FIXED EXTENSION SAVE AREA, 
UCM PAGEABLE EXTENSION BASE AND UCME PAGEABLE 
EXTENSION. C (UCMEXTBD) CALCULATE 60 

AND 80 

OF THE SPECIFIED ORE LIMIT (THE VALUE IS 
SPECIFIED IN CONSOLXX) D (MAINLINE ,DISPCONS ) 
REMOVAL OF DCMLIB A (HCFSTOR) OBTAIN STORAGE FOR 
THE HARDCOPY DATA AREA D !GETWORK) MOVED TO 
ITEAVM601 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 6 of 21 


GET A LOCAL COPY OF THE CVT POINTER THEN REBASE 
THE CVT ON IT 





SEGMENT GETSPACE THIS SEGMENT CALCULATES THE 
AMOUNT OF SPACE REQUIRED FOR THE DSABS, TIOT, AND 





QDB, OBTAINS THE LOCAL LOCK, USES THE BRANCH DSABALEN 
ENTRY TO GETMAIN TO OBTAIN THE NEEDED STORAGE, TIOTALEN 
THEN FREES THE LOCAL LOCK. STORGREQ 


| REGOO 


OBTAIN THE LOCAL LOCKS, AND THEN USE THE BRANCH 
ENTRY TO GETMAIN TO OBTAIN THE STORAGE FOR THE 
ALLOCATION CONTROL BLOCKS IN THE SCHEDULERS 
STORAGE KEY. (BRANCH ENTRY IS REQUIRED TO REQUEST 
A DIFFERENT KEY) 





— \| A. SAVE REGS ACROSS LOCKED AREA 
E REGOO / sey 2 
| SAVE | 


\r—7 


['2> 12) | 


a 1 N 


———17|/REGO8 REGOS5 
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Diagram 79. Communications Task Initialization IEAVVINT) Part 7 of 21 


ITEAVVINT - COMMUNICATIONS TASK INITIALIZATION ROUTINE STEP 05 


<protscoce- > SET UP REGS FOR BRANCH ENTRY TO GETMAIN BEFORE \ 
REG15 REGO6 : \ DROPING BASES /|}REG15 REGOS 
REGO? 


CVTMAP 


i) H 


IEECUCM 


CVTPTR 
CVT 
CVTCUCB 
IEECUCM 
UCMPXA 
UCMASCB 
GET THE LOCAL LOCK (REQUIRED FOR BRANCH ENTRY TO 
GETMAIN ) 
so 
\ —-| SETLOCK | 


OBTAIN, TYPE=LOCAL, MODE=UNCOND, 
RELATED=( GETMAIN > IEAVVINT ( VFRELOCK ) ) 


NOW, GET THE STORAGE FOR THE CONTROL BLOCKS 


7eUAN 
\-—/| GETMAIN | 
|RU, LV=(0), BRANCH=YES, KEY=1, SP=230 | 


FREE THE LOCAL LOCKS 


sU4y 

\-—/| SETLOCK | 
RELEASE, TYPE=LOCAL, 
RELATED=( GETMAIN, IEAVVINT ( VGETLOCK ) ) 


\ NOW CLEAR THE GOTTEN CORE 
/ REGOG REGOZ 
REGO3 REG13 







REGO1 REGO3Z 
REGO2 REGO8 
REG13 





REG12 
CBCOREPT 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 8 of 21 






IHAQOB lteter > SET UP START ADDRESSES OF THE QDB, TIOT;, TIOT 
=! \ ENTRIES, AND DSABS 

QDB : / 

IEFTIOTL 





TIOTI 


CBCOREPT 
QDBPTR 
TIOTPTR 
BASETIOE 
TIOTALEN 











THADSAB J -o------- > a2] QUEUE FIRST DSAB TO THE QDB THEN FILL IN THE Q0B *NTHAGDE 
N 







DSAB / 
DSABFCHN 


OSABBCHN 






a= e--a----- > 22] NEXT, FILL IN THE TIOT HEADER 
\ 






OSABPTR 
OLDDSAB —___—___— / 
HDRTLOT 


DSABPTR 
BASE TIOE 








IEECUCM 





UCMVEA UCMVEZ 
UCMVEL 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 9 of 21 


IEAVVINT - COMMUNICATIONS TASK INITIALIZATION ROUTINE 





-;------ > a3} FOREWARD AND BACKWARD CHAIN THE DSAB QUEUE. \IHADSAB 
OLDDSAB : \ / 
; 7 


DSABID 
IHADSAB 


DSAB 


OLDDSAB 
DSABPTR 

IDDSAB YES 
BASETIOE 







DSABFCHN 
DSABBCHN 


DSABLNTH 
DSABTIOT 
DSABPS 












\ a4] CONVERT THE CONSOLE ID TO EBCDIC AND CREATE THE ——*N 





IDCON DECID / CONSOLES DDNAME FROM THE PREFIX 'IEAVM' AND A — p17] DBLWORK 
DDPREFIX SUFFIX OF 3 DECIMAL DIGITS CONTAINING THE CONSOLE WORKID 
CONSID 10:; 

LENTIOTE \IEFTIOT1 
DEVICENO 7 
IEECUCM 

TIOEFSRT 
IEECUCM cha >| A. LOAD EP OF DEVICE PROCESSOR \ 
7|GPROOP GPROIP 


| EP( UCMNAME ) | 





B. ISSUE LOAD SVC | 


< > SVC & 


\IEECUCM 


/ 
UCMSBR 


IHADSAB J CRs > NOW INCREMENT THE POINTERS TO THE DSAB AND TIOT AN 


\ ENTRY ——/ |OLDDSAB 
DSAB 


DSABPTR 
BASETIOE 
LENTIOTE 





iL 





GET A JSCB USING THE GETJSCB MACRO, THEN 
INITIALIZE IT FOR COMMTASK 







A. GET A JSCB FOR COMM TASK \IKJTCB 


fu / 
\—/ GETJSCB | } TCBTIO 


\NIHAQDB 


/ 
QDBLELMP 


—_I\IKuTceB 


/ 
} TCBJSCB 


\IEZJSCB 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 10 of 21 


LEFJSSIB J ooo >| B. GETMAIN AN SSIB 


\ 
\ /|GPROOF GPROIF 
/ | GETMAIN | 


|(R) LVCLENGTH(SSIB)) SP(241) 





GPROOF GPRO1F 
C. REGISTER FORM OF GETMAIN | 


< > svc 10 












IEFJSSIB J — eee eee > ——! \IEZJSCB 
\ / 
/ } JSCBSSIB 
THIS SEGMENT RESOLVES MODULE ENTRY POINTS ANDO \IEECUCM 
REGO] IDSSIB BUILDS THE INITIAL CELL POOLS FOR WQE'S AND / 
IDMSTR ORE'S. } UCMSSIBP 
LEFJSSIB \IEFJSSIB 
THIS SEGMENT RESOLVES MODULE ENTRY POINTS FOR / 


COMMTASK BY ISSUING LOAD MACROS. WHEN ALL ENTRY 
POINTS HAVE BEEN RESOLVED, DELETE MACROS ARE 
ISSUED FOR ALL ROUTINES WHICH RESIDE IN LPA TO 
REDUCE THE MODULE USE COUNT. 





A. LOAD EP OF 2ND HALF REPLY 


| LOAD | 


JEP( ‘IEAVVRP2') 


B. ISSUE LOAD SVC | 


< > SVC 8 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 11 of 21 5 
IEAVVINT - COMMUNICATIONS TASK INITIALIZATION ROUTINE aS ci WE 
\NIEECUCM 


UCMRP 2AD 


/ 


N 


C. LOAD MONITOR ROUTINE EP 
7|GPROOP GPROIP 
LOAD 





|EP( 'IEAVMNTR® ) 


D. ISSUE LOAD SVC 


< > SVC 8 





\IEECUCM 


‘“ 


E. LOAD CONSOLE SWITCH EP 


| LOAD | 


JEP( "IEAVSWCH ' ) 


N 
/|GPROOP GPROI1P 


os 
! 


F. ISSUE LOAD SVC 


<._ _-> Svc 8 





\IEECUCM 


‘“ 


il 


G. LOAD FRR ROUTINE ADDRESS 


| LOAD 


[EP( ‘IEAVMFRR’ ) 


\ 
/|GPROOP GPRO1P 


ee ee 


H. ISSUE LOAD SVC 


< > SVC 8 





\IEECUCM 


UCMFRRAD 


7 


“‘ 


I. LOAD XMPOST RECOVERY ADDRESS 
7)GPROOP GPROIP 





LOAD 


|EP( ‘IEAVMEST' ) 


J. ISSUE LOAD SVC 





< > SVC 8 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 12 of 21 


\IEECUCM 
/ 


K. LOAD WTOR PURGE ROUTINE EP ALIAS OF IEAVMED2 \ 


/7{GPROOP GPROIP 
| LOAD | 


|EP( "IEECVPRG' ) | 


L. ISSUE LOAD SVC | 


, SVC 8 


| 





/ 
SCVTPGWR 


M. LOAD QUEUE SCANNER ROUTINE 


| LOAD | 


[EP( ‘IEAVQ700' ) 


| 
N. ISSUE LOAD SVC | 


<> SVC 8 


ee 


/ 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 13 of 21 
TEAVVINT ~ COMMUNICATIONS TASK INITIALIZATION ROUTINE 


STEP 180 





QO. LOAD CMD QUEUER RTN 


N 
/ 
| LOAD | 


GPROOP GPROIP 
|EP( 'IEAVC700' ) 


P. ISSUE LOAD SVC 


< od 








GPROOP GPROIP 


\IEECUCM 
/ 
UCMCMDQR 
Q. LOAD MPF SCAN RTN \ 
(ncaa 
LOAD 


|EP( ‘IEAVM700" ) 


R. ISSUE LOAD SVC 


< > 


SVC 8 








GPROOP GPROIP 


\IEECUCM 
‘ereren__] 
S. LOAD DUMMY WTO EXIT ROUTINE N 
SS —— faced 
LOAD 


\EP( 'IEECVXIT' ) 


T. ISSUE LOAD SVC 


< > 





\ITEECUCM 
/ 
UCMCVXIT 
ISSUE DELETES FOR THE ROUTINES IN LPA WHICH WERE 
JUST LOADED 


A. DELETE TO REDUCE USE COUNT 





DELETE 
[EPC 'IEAVVRP2' ) 
B. DELETE SVC | 
< > SVC 9 J 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 14 of 21 


C. DELETE TO REDUCE USE COUNT 


[ eee i stst—<‘—sSCSOY 


JEP( ‘IEAVMNTR' ) 


D. DELETE SVC | 





E. DELETE TO REDUCE USE COUN | 


| DELETE | 


|EP( ‘IEAVMFRR' ) | 


F. DELETE SVC | 





G. DELETE TO REDUCE USE COUN | 


| DELETE 


[EP( ‘XEAVMEST ‘ ) 


| 
H. DELETE SVC | 





< > svc 9 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 15 of 21 


TEAVVINT - COMMUNICATIONS TASK INITIALIZATION ROUTINE 


I. DELETE TO REDUCE USE COUNT 


| DELETE | 


JEP( 'IEECVPRG' ) 


J. DELETE SVC | 





< > SVC 9 





K. DELETE TO REDUCE USE COUNT 


JEP( ‘IEAVQ700' ) | 


avemeee 
=—— 


L. DELETE Svc | 





M. DELETE TO REDUCE USE COUNT | 


| DELETE | 


JEP( 'IEAVC700' ) | 


N. DELETE SVC | 





< > SVC 9 





QO. DELETE TO REDUCE USE COUNT | 


| DELETE | 


|EP( 'IEAVM700° ) | 


P. DELETE SVC | 


< > SVC 9 





Q. DELETE TO REDUCE USE COUN 


| DELETE | 


JEP( ‘IEECVXIT' ) | 


R. DELETE SVC | 


< > SVC 9 





STEP 192 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 16 of 21 


THIS SEGMENT WILL BUILD THE INITIAL CELL POOLS 
FOR THE WQE'S, CQE'S, AND ORE'S. 


IHAWQE r------ ~> [22] CALCULATE THE NUMBER OF 1024 BYTE BLOCKS NEEDED \ 
-: \ FOR ENOUGH WQES TO HOLD 80 7 | NUMQEBLK 
/ OF THE WIOBUF LIMIT SPECIFIED AT IPL. 






CALCULATION = (( 80 

OF WQES X (WQE LENGTH + 4 CELL HEADER 
BYTES/WQE)) + 32 CELL POOL HEADER BYTES + 1024 
BYTES FOR FIXED POINT ROUND DOWN) / 1024 BYTES 
PER CELL 


NUMQEBLK 
MAXWNQE 


IEECUCM 


\ [ze] GET STORAGE FOR WQE CELL POOL 
NUMQEBLK / 
ONEK pe 
[REGoo —— 3, GETMAIN , / | GPROOF naar erwene 
naar erwene 


I(RU) LV(REGOO) BNDRY SP(229),ss—<(<i‘i‘SCS™S LV(REGOO) BNDRY SP(229) 


A. RC/RU FORM OF GETMAIN 


ae 





LY28-1200-4 © Copyright IBM Corp. 1982, 1987 Section 5. Method of Operation 5-595 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Diagram 79. Communications Task Initialization (IEAVVINT) Part 17 of 21 


IEAVVINT - COMMUNICATIONS TASK INITIALIZATION ROUTINE STEP 23 
poy > 23] BUILD WQE CELL POOL \ 
\ /|REGO5 REGO3 


\-—| BLDCPOOL 


SP=229, POOLSIZ=(5), CSIZE=(3), 
BRANCH=EYES, CPADDR=(1) 


IHAWQE 
Fy . 
Li 


\ \IEECUCM 
REGOO / ° 
\ 





cprcccct > 24] FIND THE NUMBER OF SYSGENED OPEN PENDING CONSOLES 
YES : N / | OPENCONS 
/ UCMDVE PT 
IEECUCM 
IEECUCM 
UCMVEA UCMVEZ 
UCMVEL 
IHACTM a cloateateatentoata -> 25 CALCULATING THE BLOCK SIZE FOR CQE CELLPOOL. ( N 
CQECONST IS A SCALING FACTOR WHICH IS THE INVERSE 7 | CQECONST 


OF THE NUMBER OF CELL BLOCKS NEEDED FOR TWO 
SCREENS OF MESSAGES PER CONSOLE. INVERSE BECAUSE 
TRUE NUMBER IS LESS THAN ONE. ) 


CALCULATION = { 1024 BYTES PER CELL 7 ( 2 
SCREENS/CONSOLE X 40 LINES/SCREEN X 1 CQE 
ENTRY/LINE X 1 CQE/ 50 CQE ENTRIES X (CQE LENGTH 
+ & CELL HEADER BYTES/CQE) + 32 CELL POOL HEADER 
BYTES ) ) + 1 FOR ROUNDING 


--------- -> CALCULATE THE NUMBER OF 1024 BYTE BLOCKS NEEDED N 
/ 


FOR ENOUGH CQES TO HOLD TWO SCREENS OF MESSAGES | EBLK 






NUMQEB LK 
MINCQE MAXCQE 


ON EVERY SYSGENED OPEN PENDING CONSOLE 






MINCQE MAXCQE 


GET STORAGE FOR CQE CELL POOL 
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Diagram 79. Communications Task Initialization TPEAVVINT) Part 18 of 21 





———\, N 
/ | GETMAIN | /|\GPROOF GPROLF 
—— eee GPR15F 
IHACTM }(RU) LV(REGOO) BNDRY SP(CQESP) | 


CQESP 
A. RC/RU FORM OF GETMAIN 


< > SVC 120 





THACTM Seoaer > BUILD C@E CELL POOL 
\ 
; | 
suo | 
\-—/| BLDCPOOL | 
NUMQEBLK ee 
SP=CQESP, POOLSIZ=(5), CSIZE=(3), 
BRANCH=YES, CPADDR=(1) 


Ls reecuce 
[ere] 
N GET STORAGE FOR ORE CELL POOL 

NUMORB LK / 

ONEK | 


| GETMAIN | 


|(RU) LVCREGOO) BNDRY SP(231) LOCI BELON) | 


A. RC/RU FORM OF GETMAIN | 


< > svc 120 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 19 of 21 


IEAVVINT - COMMUNICATIONS TASK INITIALIZATION ROUTINE STEP 30 


BUILD ORE CELL POOL 


s—AN 


\-—/| BLDCPOOL 


SP=231, POOLSIZ=(5), CSIZE=(3), 
BRANCH=YES, CPADDR=(1) 







\ 
7\|REGOS REGOS 


ITEECUCM 





\ 
UCMFXPTR 
\ 
7|\GPROOP GPROIP 


A. LOAD COMM TASK ENF LISTEN EXIT ROUTINE 


| LOAD | 


JEP( ‘IEAVG600' ) 


B. ISSUE LOAD SVC | 


< > SVC & 





—_ 
/ 
[ UCMFLSTN 
C. DELETE TO REDUCE USE COUN 


| DELETE | 


JEP( ‘LEAVG600° ) | 


\ 
/ |GPROOP 


D. DELETE SVC | 


< > SVC 9 





ITEECUCM \IEECUCM 


\ 132 | CALCULATE 60, AND 80 
‘ae OF THE ORE LIMITS SPECIFIED IN CONSOLXX AND / 
STORE THEM IN THE UCM FIXED EXTENSION BASE UCMF600R 


UCMFSO0OR 
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C Diagram 79. Communications Task Initialization (IEAV VINT) Part 20 of 21 












IEECUCM \ [33] CALCULATE 60, 80, AND 95 
pv OF THE WQE LIMITS SPECIFIED IN CONSOLXX AND 
STORE THEM IN THE UCM FIXED EXTENSION. 
UCMF 95NQ 
CALCULATE 75, 80 AND 95 PERCENT VALUES OF THE wire 


DECLARED ABOVE. 











, GPROOF GPROIF 
GPRI5F 


\| A. OBTAIN WORK AREA FOR IEAVH600 
VH600WLN / 
ee ee GETMAIN 


|(RU) LVCVHEOOMLND SPC229) LV(VH600WLN) SP( 229) 


B. RC/RU FORM OF GETMAIN 





< 





NUMBER OF MESSAGES WHICH CAN BE RETAINED. 

IEAVH600 SHOULD BE CHECKED TO VERIFY THAT 

VH60OWLN PROVIDES SUFFICIENT LENGTH. A CHANGE TO 
IEAVH600 MAY NECESSITATE A CHANGE TO VH600WLN 

; 
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Diagram 79. Communications Task Initialization (IEAVVINT) Part 21 of 21 


IEAVVINT - COMMUNICATIONS TASK INITIALIZATION ROUTINE STEP 36 


ITEAVM601 SHOULD BE CHECKED TO VERIFY THAT HCDALEN 
PROVIDES SUFFICIENT LENGTH. A CHANGE TO IEAVM601 
MAY NECESSITATE A CHANGE TO HCDALEN DECLARED 
ABOVE . 


\| A. GETMAIN THE HARDCOPY DATA AREA BELOW THE 16M LINE 


HCDALEN / 
| GETMAIN | 


|(RU) LVCHCDALEN) SP(229) LOC(BELON) | 





B. RC/RU FORM OF GETMAIN | 


< > SVC 120 





IECDATB t ~----~< —> THE SECOND ENTRY IN THE I/O ATTENTION TABLE MUST ———!\ 
N\ BE MODIFIED TO REFLECT THE COMM TASK ADDRESS /|ATBPTR 
IECOIOCM 


ATBITF 
| IOCATTBL — ATBASID 


IEECUCM 








IEECUCM precccce- > IF THE HARDCOPY DEVICE IS NOT SYSLOG THEN POST 
=: COMMTASK THAT IEAVMWTL MAY BE CALLED TO HARDCOPY 

UCMSYSG THE MESSAGES BUFFERED BY NIP. 

UCMNPECB 


A. ISSUE POST SVC 


< > Svc 2 


IF A DISPLAY CONSOLE IS IN THE SYSTEM LINK TO THE 
DIDOCS INITIALIZATION ROUTINE. REGISTER 13 MUST 
POINT TO A 72 CHARACTER SAVEAREA. THIS CODE USES 
THE SAVEAREA SET UP BY PL/AS 


fos eer s >| A. LINK TO DIDOCS INIT 
x00 nn iia: 


|EP( *"IEECVGCI' ) | 


B. ISSUE LINK SVC | 


< > SVC 6 
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Diagram 80. Subsystem Interface Initialization (IEFJSINT) Part 1 of 6 


From Master Scheduler {fnitialization, 


(IEEVIPL) 
Input Process Output 





JESCT 











Initialize the job entry 
subsystem communication 
table. 


1 






CVTJESCT 





i SSCVT chain 


No. of subsystems 


—> 


IEF JRECM 
(EF JRECF 


4 JESPEXT 


SSPL 
SSPSSCT='1' 


2 Create a SSCVT for the 
master subsystem. 






"MSTR' 


routine 


SESS 
Vy i 
teres 
Piersinre 


JESPEXT 
JESSID 
JESSVERS 
IEFSJCNL 
IEFSJRTE 


—- 


{EF XB501 
IEFSJATE 


—> 


Ll 


Wa jo Ayadoig — syeiayeya’ posuaci’] 


IAG] JO STEMI IBA’ P9}IYSOY,, 


L861 ‘7861 “du0D Wal 148144dop @ b-00ZI-8ZAT 


voreladg Jo poylayy ‘¢ UOTIIaS 


£09-¢ 


Cc 


Diagram 80. Subsystem Interface Initialization (IEFJSINT) Part 2 of 6 


Extended Description Module Label 


Subsystem interface initialization (IEFJSINT) is called 
from master scheduler initialization (IEEVIPL) to create 
the control blocks that allow system routines to request 
services from the master subsystem. The subsystem inter- 
face uses these control blocks to identify the subsystem 
that will service a subsystem request. IEFJSINT builds an 
SSCVT for the master subsystem. Additional subsystems 
can be specified in the IEFSSNxx members of 
SYS1.PARMLIB; IEFJSIN2 (Diagram 75) creates the 
SSCV Ts and initializes these additonal subsystems. 


1  IEFJSINT initializes fields in the job entry subsystem IEFJSINT 
communication table (JESCT). In the JESCT, 

IEFJSINT initializes the total number of subsystems to 

zero, stores the pointer to the SSCVT chain in the JESCT 

field after the chain is built in step 2. [EFJSINT obtains 

storage for a pageable extension of JESCT (JESPEXT). 


Once storage has been obtained for the JESPEXT, IEFJSINT 

does the following: 

@ Initializes the control block identifier (JESSID) of the 
JESPEXT. 

@ Initializes the version number (JESSVERS) for the 
JESPEXT. 

@ Loads the scheduler JCL facility control routine, 
IEFSJCNL, and saves its address in the JESPEXT. 

@ Loads the scheduler JCL facility router routine, 
\EFSJRTE, and saves its address in the JESPEXT. 

@ Loads the initiator message module, JEFIB651, and saves 
its address in the JESPEXT. 

{EFJSINT then does the following: 

e@ Loads the subsystem interface resource manager routine, 
IEF JRECM, and saves its address in the JESCT. 

@ Loads the end-of-task entry point, IEFJRECF, of the 
subsystem interface resource manager routine and saves 
its address in the JESCT. 


Extended Description Module Label 


2 For the master subsystem (MSTR), initialize the sub- IEF JSINT 
system service routine parameter tist (IEFZ8601)} to 

indicate that a SSCVT is to be built. Then call the subsys- 

tem service routine (IEFJSBLD). See Diagram 69. 
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Diagram 80. Subsystem Interface Initialization (IEFJSINT) Part 4 of 6 


Extended Description Module 


3 Set up the parameter list (SSPSAST='1') to build a IEF JSINT 
subsystem allocation sequence table (SAST), 

(SSPSBCT='‘1') to build the subsystem communication vec- 

tor table (SSCVT), and the master subsystem’s vector tabie 

(SSVT) (SSPSSVT="1'). Ideniify the subsystem as the 

master subsystem (SSPNME=C ‘MSTR’). The parameter 

list includes the address of a table (IEF JMSFC) containing 

the data needed to build the master subsystem’s SSVT’. 

Invoke IEFJSBLD. 
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Diagram 80. Subsystem Interface Initialization (IEFJSINT) Part 6 of 6 


Extended Description Module Label 


5 Locate the master subsystem’s SSCVT and store the IEF JSINT 
SSVT address, returned in the parameter list, in the 
SSVT (fietd name SSCTSSVT). 


Return control to the caller. 


Recovery Processing: 


None. 
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Diagram 81. Subsystem Service Routine (IEFJSBLD) Part 2 of 14 


Extended Description Module 


IEFJSBLD performs one or more of the following services: 


Builds a subsystem communication vector table (SSCVT). 
Builds a primary subsystem communication vector table 
(SSCVT). 

Builds a subsystem vector table (SSVT). 

Links to a subsystem initialization routine. 

Builds a hash table (SHAS) of SSCVT addresses. 

Builds a subsystem allocation sequence table (SAST}. 
Disables selected SSVT function codes. 

Enables selected SSVT function codes. 


(EF JSBLD is protected by its own ESTAE environment. 
The input to 1EFJSBLD is the subsystem service routine 
parameter list (SSPL) that contains bits that indicate 
which function is being requested and what data is 
needed to process the request. 


1 


If this isa SSCVT build request (the SSPSSCT bit is IEFJSBLD 
on), or a primary SSCVT build request (the SSPRMRY 


bit is on) then continue with this step. Otherwise, go to 
step 2. 


Validate the subsystem name. The subsystem name 

cannot begin with a blank character. If the name is 

invalid, then set a return code of 4 and go to step 4; 

otherwise continue with step 1. 

If the SSCVT chain pointer in the JESCT is 0, then IEFJSBLD 
this is the first request to build an SSCVT, and no 

duplicate subsystem name exists. If this is not the 

first SSVT build request (the SSCVT chain pointer 

is not 0}, then scan the SSCVT chain, searching for a 

subsystem name that matches the input subsystem 

name. If a duplicate name is found, invoke the 

message writer, IEF JSIMW, to issue message 

IEE730I, set a return code of 8, and proceed to IEF JSIMW 
step 4. 


If a duplicate subsystem name is not found, continue 

with step 4. 

Issue a GETMAIN macro instruction to obtain storage IEFJSBLD 
from subpool 241 (pageable CSA) for the SSCVT. 

If the GETMAIN fails, invoke the message writer, 

IEF JSIMW, to issue message [EF 7591, set a return 1EF JSIMW 
code of 24, and return to the caller. 


Label 


SCANSSCT 


SSCTBLD 


C C 


Extended Description Module Label 
| 
d. if the GETMAIN is successful, initialize the SSCVT 
with the control block identifier C’SSCT‘ and the 
subsystem name and increase the count of the number IEFJSBLD SSCTBLD 
of subsystems (the JESNRSS field in the JESCT) 
by one. 
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Input Process Output 


1 (continued) 
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E 
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Diagram 81. Subsystem Service Routine (IEFJSBLD) Part 4 of 14 


Extended Description Module Label 


1 (continued) 


d, Chain the new SSCVT. If the request is for a primary IEFJSBLD SSCTBLD 


subsystem or the first request, chain the SSCVT to the 
JESCT. Otherwise, chain the SSCVT to the previous 
SSCVT. 


2 If the SSPSSVT bit is on, then this is a request to 
build an SSVT. Continue with steps 2b-2c. If 

this is not a request to build a SSVT, go to step 3a. 

a. Issue the GETMAIN macro instruction to obtain 
storage for the SSVT from the subpool specified in the 
input SSVT data, mapped by IEFJSBVT. The storage 
size=SSVT fixed area (260 bytes) + (4 * the number of 
functions supported by the subsystem). If the GETMAIN 
fails, invoke the message writer, IEF JSIMW to issue 
message IEF 759], set a return code of 24, and return to IEF JSIMW 
the caller. If the GETMAIN is successful, clear the 
SSVT storage and build the SSVT. The subsystem 
interface uses the SSVT to route requests to 
subsystems. 


Store the maximum number of functions supported 
into the SSVT. 


For each subsystem function routine specified in the 
input SSVT data, check the SSPGLOAD bit in the 
subsystem parameter list to determine if the caller re- 
quested that a LOAD macro instruction, global option 
be used. If so, issue the LOAD macro instruction with 
this option. Otherwise, issue the LOAD macro instruc- 
tion without the global option, followed by a DELETE 
macro instruction. Save the address in the SSVT and 
initialize its corresponding function code. 


A system routine requests a subsystem service by 
Passing a function code to the subsystem intarface. 
This code is a number between 1 and 256 that 
enables the subsystem interface routine to determine 
which subsystem routine is to get control. The code 
refers to a single byte in the SSVT’s function matrix. 


IEFJSBLD SSVTBLD 


Extended Description 


A code of 1 refers to the first byte in the matrix, a code of 
2 refers to the second byte, and so on. The matrix 

byte contains a value that is an index into the list 

of entry point addresses for the subsystem’s function 
routines. A value of 1 refers to the first address, a 

value of 2 refers to the second address, and soon. A 

value of 0 indicates that the function is not offered by 


this subsystem. 
Store the SSVT address in the input parameter list 


in field SSPSVTAD. 
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Diagram 81. Subsystem Service Routine (IEFJSBLD) Part 5 of 14 


Input Process Output 


Parameter list 









i 
3 Disabled specified SSVT function SSCTSSVT 
codes, if requested. _ 


CO 
SSPSVTD 
Cd 


SSVTFNUM 
Number of functions 










SSCVT tEFJSBVT 4 Enable specified SSVT function SSVTFCOD | 
$< a odes, if ted Function matrix 
JESFUN codes, if requested. 
_SSETSENT Number of functions SSVTFRTN 
. 
JSBMAXFR Pointers to the 


subsystem 
function routine 


Number of routines 
JSBDATA 

SSVT data 

JSBNME 

SSVT name 
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Diagram 81. Subsystem Service Routine (IEFJSBLD) Part 6 of 14 


Extended Description Modute Label 


3 Check the bit, SSPFCDIS, to determine if this is a IEFJSBLD SSVTEDIS 
request to disable selected SSVT function codes. If 

the bit is off, continue with step 4. Otherwise, check the 

SSVT pointer fleld (SSCTSSVT) In the subsystem commu- 

nications vector table (SSCVT), mapped by IEFJSCVT, to 

determine that there is an SSVT for the specified subsystem. 


If there is an SSVT for the specifled subsystem, zero the 
entry in the function code erray for each SSVT function 
code and continue processing with step 5. 


If there is no SSVT for the specified subsystem, set a return 
code of 36 and return to the caller. 


4 Check the bit, SSPFCEN, to determine if this is 8 SSVTEN 
request to enable selected SSVT function codes. If the 

bit is off, continue with step 5. Otherwise, check the SSVT 

pointer field to determine that there Is an SSVT for the 

specified subsystem. 


lf there is an SSVT, for each subsystem function routine 
specified in the input SSVT data (JSBDATA), check the 
SSPGLOAD bit in the subsystem parameter list to deter- 
mine if the caller requested that a LOAD macro instruc- 
tion, global option, be issued. If so, issue the LOAD with 
this option. Otherwise, issue the LOAD without the global 
option, followed by a DELETE macro instruction. 


Compare the address of the subsystem function routine 
with each address inthe SSVT. If there is a match, initialize 
the SSVT function code entry with the index tothe function 
routine address. If the address is not in the SSVT, put the 
address in the next available entry in the SSVT function 
routine pointer array (SSVTFRTN) and store the index into 
the corresponding SSVT function code entry. 


If there is no match, set a return code of 44 to indicate 
that there is insufficient space in the SSVT for additional 
subsystem function routine addresses and return to the 
caller. 
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Diagram 81. Subsystem Service Routine (IEFJSBLD) Part 7 of 14 
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Diagram 81. Subsystem Service Routine (JEFJSBLD) Part 8 of 14 


Extended Description Module Label 


5 If this is a subsystem initialization request (bit lIEFJSBLD = LINKINIT 


SSPINIT of the input parameter list is set on), link 


to the subsystem initialization routine and continue 
with this step. Otherwise, go to step 6. 


a. 


Determine if the subsystem has already been initialized. 
Scan the SSCVT chain to locate the subsystem’s SSCVT. 
If either (1) the SSCTUPSS bit is on or (2) the pointer 
to the SSVT (SSCTSSVT} is not zero or (3) the 
SSCTSUSE field is not zero, the subsystem has already 
been initialized. In this case, set a return code of 12 

and go to step 6. 


. If the subsystem has not been initialized, issuea BLDL 


macro instruction to determine if the initialization 
routine for this subsystem exists in SYS1.LINKLIB. If 
the initialization routine is not found, invoke the 
message writer, IEFJSIMW to issue message IEE859I, 
set a return code of 16, and go to step 6. 

If the subsystem initialization routine is found, set 

up the subsystem initialization parameter list 
(IEFJSIPL) as follows: 


e JSLGTH — length of the parameter list. 

e JSICOND — console id to which the subsystem 
initialization routine should issue messages. 

e JSILGTPR — length of user parameters. 

e JSIADRPR — address of user parameters. 


Link to the subsystem initialization routine, passing 
the SSCVT and the JSIPL. 


If an ABEND occurs in the subsystem initialization 
routine, no dump is taken. IEF JSBLD issues message 
[EF 7591 and returns to its caller with a return code of 20. 
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c. Scan the SSCVT chain, 
inserting the subsystem 
name into the table. When 
the master subsystem’s 
SSCVT is encountered, 
place its name in the 
last table entry. 










d. Chain the SAST to the 
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Diagram 81. Subsystem Service Routine (IEFJSBLD) Part 10 of 14 


Extended Description Module Label 


6 If this is a request to build a SAST (the SSPSAST 
bit is on}, then continue with this step. If this is 


1EFJSBLD SASTBLD 


not a request to build a SAST (SSPAST bit is off}, then 
go to step 7. 


Cc. 


Obtain space for the SAST from subpool 241 (pageable) 
CSA). The size of the SAST is equal to 12 bytes times 
the number of subsystems plus 8 bytes for the header. 
The number of subsystems is in JESNRSS. 

Finish initializing the SAST header with the control 
block id, the number of entries in the table, and the 
size of the table. 

Scan the SSCVT chain to determine the subsystem 
names that have been defined to the system during 
master scheduler initialization. As a name is found, 
place it in the table. Place the name of the master 
subsystem in the last table entry. 


. Chain the SAST to the JESCT (field JESSASTA). If 


a SAST address already exists in field JESSASTA, then 
chain the new SAST and free the old SAST. 
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Diagram 81. Subsystem Service Routine (IEFJSBLD) Past 11 of 14 


- Input Process 
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Error 


b. For each subsystem 
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@ Scan the SSCVT chain, 
calculating the hash 
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@® Store the address of 
the SSCVT in the hash 
table. 





@ Save the address of the 
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c. Store the address of 
the hash table. 
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Diagram 81. Subsystem Service Routine (IEFJSBLD) Part 12 of 14 


Extended Description Module Label 


7 ‘(If a hash table is to be built (bit SSPHASH is on in the IEFJSBLD HASHBLD 
input parameter list), then continue with this step; 

otherwise, go to step 6. The hash table contains SSCVT 

addresses. The subsystem interface uses the hash table to 

locate an appropriate SSCVT directly rather than scanning 

the SSCVT chain to locate it. 


a. Issue the GETMAIN macro instruction to obtain 
storage from subpool 241. The size of the storage 
ares requested equals 12 bytes of fixed area plus 
(4 * number of entries in the hash table). Zero the 
acquired storage. If the GETMAIN fails, invoke 
the message writer, IEF JSIMW to issue message 
[EF 7591, set a return code of 24, and return to the 
caller. 

b. Scan the SSCVT chain, calculating the hash value 
for each subsystem. The hash value is used as an 
index into the hash table. The hashing algorithm 
is: 


HASH = (The subsystem name divided by the number 
of slots in the table. The remainder + 1 is used as 
the hash value.) 


If a hash table entry is zero, then this subsystem is 
not a synonym: store the SSCVT addrass in the 
entry. If a hash table entry is not zero, then this 
subsystem is asynonym. Scan to the end of the 
synonym chain (indicated by a SSCVT synonym 
pointer [SSCTSYN] of zero). Store the SSCVT 
address for the newly-found synonym in the last 
SSCVT synonym pointer field. 


While scanning the SSCVT, the SSCVT address is 
kept in the hash table. Thus, when scanning is complete, 
the hash table will contain the address of the jast 
SSCVT creatad during master scheduler initialization. 

c. Store the address of the hash table in the JESCT 
(field JESHASH). 
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Diagram 81. Subsystem Service Reutine (IEFJSBLD) Part 14 ef 14 


Extended Description Module Label 
8 = Set a successful return code of zero and return to [EF JSBLD 
the caller. 


Recovery Processing 


An ESTAE protects all of IEF JSBLD processing from tEFJSBLD ESTAEBLD 
abends. If an abend occurs during JEFJSBLD processing, 
several actions are possible. 


@ Percolate the error if the GETMAIN ABENDs on 
the first attempt to build a SAST or if, in building 
the SSVT for the master subsystem, the LOAD fora 
subsystem function routine abends. For all other 
situations attempt a retry. 

@ Take an SDUMP unless the error is a machine check 
or this ESTAE was percolated to or the subsystem 
initialization routine was in control when the error 
occurred. 

@ Record diagnostic information in the variable 
recording area of the SDWA. 


The retry of IEFJSBLD consists of clean-up processing 
which depends on when the error occurred. The retry 
frees any storage that was obtained and issues the 
DELETE macro instruction for any outstanding LOADs. 


If a LOAD abended, return the name of the function 
routine that was being loaded. 
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Diagram 82. Allocation Initialization (IEFAB410) Part 1 of 4 
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4 Build the mountable 
device class array. 
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Diagram 82. Allocation Initialization (IEFAB410) Part 2 of 4 


Extended Description Module Label 


The allocation initialization routine initializes allocation 
control blocks, builds the UCB pointer list (UPL), and builds 
the mountable device class array. It passes to IEEMB881 the 
address of the initialization routine, |EFHB411, that will 
initialize the allocation address space (ALLOCAS). IEFAB4I0 
attaches the EDT verification routine, |EFEB400, to verify 
that the description found in the EDT matches the UCBs 

in this system. 


1 IEFAB4I0 sets up an ESTAE environment for the IEFAB410 
non-address space initialization (Steps 1-5 in this 

diagram). The recovery routine is |EF AB4ED, which 

will route contro! to IEFAB4EH, If the ESTAE is unsuc- 

cessful, IEFAB41I0 issues an ABEND with a system comple- 


tion code of X‘O5C’ and a reason code of 5 in register O. 


2 ~=IEFAB4IO initializes the JESTIOTS and JESMAXDD 

fields in the JESPEXT to contain the TIOT size and 
the maximum number of DD statemtns that are allowable. 
The TIOT size is obtained from CSECT IEFAB445 and 
the maximum number of DD statements is a calculation 
based on the TIOT size. 


3 IEFAB4IO establishes the allocation entry points by INITCBS 
storing the entry point address obtained via a LOAD 

macro instruction into the JESCT (fields JESALLOC, 

JESUNALC, and JESCATL), the JESCT extension (fields 

JESDB401, JESXVNSL, JESGB4DC, JESGB4UV, 

JESAB445, JESGB400, JESGDTOK), and the CVT (field 


CVTDARCM). 


4  \EFAB410 issues a GETMAIN macro instruction to 

obtain storage from subpool 241, key 1, for the mount- 
able device class array. The array has two entries, one for 
DASDs and one for tape devices. |EFAB410 places the 
address of the array in JESMNTP. 


C 


Extended Description Module Label 


5 IEFAB4I0 issues a GETMAIN macro instruction to BUILDUPL 
obtain storage for the UPL from the subpool 241, 


scheduler key, with option LOC=ANY. 


IEF AB4)0 initializes the UPL header, scans the device 
number entries in the EDT, and uses the IOSLOOK service 
to locate the UCB address that corresponds to the device 
number. If a device number in the EDT has a corresponding 
UCB address, IEFAB4I0 initializes the UPL with the address 
in the UCB. If a device number in the EDT does not have a 
corresponding UCB address, it sets the UPL field to zero. 
IEFAB4I0 stores the address of the UPL in JESUPL, the 
number of UCBs in the system in JESNUCBS, the total 
number of tape and DASD UCBs in JESAUCBS, and sets 

a flag (SJESALRDY) to indicate that allocation is available. 
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Diagram 82. Allocation Initialization (IEFAB4I0) Part 3 of 4 


Input Process 
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verify the EDT and UPL 
entries. 
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10 Cancel the recovery 
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Diagram 82. Allocation Initialization (IEFAB410) Part 4 of 4 


Extended Description Module Label 


G JIEFABS4IO attaches IEFEB400 (specifying the ESTAE 

routine, |IEFAB4ED, which will route contro! to 
IEFAB4EH), IEFEB400 verifies that entries in the EDT 
match the UCBs in the system. It issues messages IEF924] 
and IEF925I for any discrepancies. If the ATTACH macro 
fails, IEFAB410 issues an ABEND with a system comple- 
tion code of X’05C’ and a reason code of X'101’. 


|EFEB400 


1EFAB410 


7 =IEFAB&4IO sets up a second ESTAE environment to 
cover the allocation address space initialization proces- 
sing. The recovery routine is IEFAB4E6. If the ESTAE is 
unsuccessful, IEFAB4I0 issues an ABEND with a system 
completion code of X‘05C’ and a reason code of 5. 


SETSASI 


IEFAB4I0 sets up the parameter \ist for |JEEMB881 and calls IEEMB888&1 
JEEMB881 to create and initialize the allocation address 
space. The parameter list contains three fields: 


e USRATTR contains the length of the attribute (in double 
words) and describes the attributes of the allocation 
address space as follows: 

— The address space is for data use only (that is, it 
cannot be started from the operator’s console), and 
ig tO remain in limited function start mode. 

— The address space is to be non-swappable. 

— The address space is not to be terminated (that is, 
RTM is to ignore any request to terminate it). 


e USRPGMN contains the address of |EFAB411, the 
routine that will initialize the allocation address space. 


e USRPARMS contains X‘0007’, the length of the name of 
the address space, and ‘ALLOCAS’, the name of the 
allocation address space. 


Extended Description Module Label 


8 1IEFAB410 checks the return code from |EEMB881 in 

register 15. If the return code is not zero, then the 
initialization failed, and IEFAB4I0 issues an ABEND with a 
system completion code of X‘05C’ and a reason code of 5 in 
register 0. If it is zero, then the initialization was successful, 
and register 1 contains the address of the ASCB for the new 
address space. IEFAB4I0 extracts the ASID from this ASCB, 
for the new address space. IEFAB410 extract the ASID from 
this ASCB, places it in the JESALLOA field of the JESCT, 
and cancels the ESTAE, which covered the allocation address 
space initialization. This action re-establishes the recovery 
routine, IEFAB4ED. 


IEFAB410 


9 IEFAB4I0 waits for IEFHB411 and iIEFEB400 to 

complete. If |EFEB400 found any zero addresses in the 
UPL (indicating that a UCB was defined in the EDT but does 
not exist in the system), {|EFAB410 calls IGFPTERM to issue 
message |EF928] and puts the system in a X ‘0200’ wait state 
with a reason code of X ‘0002’. 


10 JIEFAB4I0 cancels the recovery environment and 
returns to IEEVIPL. 


Recovery Procassing 


JEFAB4ED handles abnormal terminations of allocation 
failures not related to the allocation address space (ALLOCAS). 
IEFAB4ED places diagnostic data in the SDWA and produces 
a dump of the failing routine’s address space. Areas dumped 
are the LPA, all the PSA, SQA, SWA, LSQA, and trace 

tables, Also, /EFAB4ED writes an error record 
SYS1.LOGREC. It then routes control to specialized re- 
covery routines for the allocation subcomponent in control 

at the time of the failure. In the case of IEFAB4I0, the 
recovery routine is [EFAB4EH., 


|EFAB4E6 handles abnormal terminations of tasks that 
create, initialize, or update the allocation address space 
(ALLOCAS). |IEFA84E6 places diagnostic data in the SOWA 
and produces an SDUMP of both ALLOCAS and the failing 
routine’s address space. Areas dumped are the LPA, LSQA, 
all of the PSA, SQA, trace tables, and private regions. Also, 
|IEFAB4E6 writes an error record to SYS1.LOGREC and 
issues message IEF 1001. 
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Diagram 83. Allocation Address Space Initialization (IEFHB4I1) Part 1 of 2 
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Tnagram 83. Allocation Address Space Initialization (IEFHB4I1) Part 2 of 2 


Extended Description Modute Label 
Allocation address space initialization obtains and initializes 

all the necessary control blocks in the allocation address 

space (ALLOCAS). This initialization includes obtaining 

storage in CSA for the program call display allocation 

lookup table (PCDALT) parameter list, loading the DALT 

manager (IEFHB4I0), establishing a cross memory environ- 

ment, and entering a never-ending wait, leaving 


ALLOCAS in limited function start mode. 


1 Set up an ESTAE recovery environment. The ESTAE 
recovery routine is IEFAB4E6. 


lIEFHB411 


2 Load the display allocation lookup table (DALT) IEFHB411 
manager (IEFHB4i0) from SYS1.LINKLIB into 


ALLOCAS. 


3 Set up across memory environment. Set the authori- IEFHB411 XMEMPROC 
zation index to one, using the AXSET macro instruc- 
tion. ALLOCAS can then perform program transfers to any 
address space. A linkage index has already been reserved in 
the system function table (SFT) with the option to allow a 
global connection among all current and subsequent address 
spaces. Using the ETCRE macro instruction, create an 
entry table to define the entry points into ALLOCAS. 
Connect this entry table to the linkage table using the 
ETCON macro instruction with the linkage index from the 
SFT. Other address spaces can now perform program calls 


to ALLOCAS. 


Extended Description Module Label 


Calculate the length of the allocation descriptor block IEFHB411 GETBLOCK 
(ADB), display allocation index table (DAIT), display 
allocation vector table (DVT), and all display allocation 
lookup tables (DALTs). Issue a GETMAIN macro instruc- 
tion to obtain a block of key 0 storage from subpool 229 
equal to the calculated length. Set the JESALLOP field of 
the JESCT equal to the address of the area obtained. The 
first section of this area becomes the ADB; store the ADB 
acronym in it; the next section becomes the DAIT ; store 
the DAIT acronym, the unique index into the DAIT, and the 
UCB address in it; the third section becomes the DVT; store 
the DVT acronym in it, and store the DVT address and DAIT 
address in the ADB. The fourth section is sp/it up into the 
required number of DALTs. Store the DALT acronym in each 
DALT and store its address in the DVT. 


5 Activate the allocation address space by setting the 
JESUASR bit on. Then post the EAERIMWT ECB to 
allow |EFAB4I0 to finish its processing. 


6 Enter a never-ending wait; that is, ALLOCAS remain 
in limited function start mode. If this wait is ever 
posted, then an SDUMP is in process for the allocation 
address space {ALLOCAS). WAIT for the SDUMP ECB, 
JESDUECEB, to oe posted, then return to IEEPRWI2 with a 
return code of 4 indicating that an error has occurred. 


Recovery Processing 


See Diagram 70 for information on recovery processing. 
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Diagram 84. System Management Facilities Initialization Router (IEEMB820) Part 1 of 2 


From master scheduler 
initialization, Step 15 


Input Process Output 


1807] WU] WaIsks VX/SAW 879-C 


L861 ‘7861 “d40g Wea] 1481sAdop @ p-Q0ZI-8ZAT 


IFASTART 


PARMLEN 


EAECB 
EAERIMWT 


CVTSMCA 





EATTRLEN 
—— 


EATTRTYP 


ee 
EATTPRIV 

_—_—_———— 
EATTFRCE 


«@— (address of 
SASI ECB) 


SMC AMAN 
— 





Set up address space 
attributes and 
parameter list. 


Create the SMF 
address space, 


Wait for the address 
space to be initialized. 


If SMF recording is 
being used, start 
internal accounting. 


Return to master 


1EEMB881 


System address 
space create 


IEFSMFIE 


SMF 


initialization 
exit 





scheduler initialization 





EATTRLEN 


EATTRTYP 


EATTPRIV 


EATTFRCE 


Register 15 
Return Code 


Register 2 


USPPGMN 


IFASTART 


USRPARMS 


PARMLEN 


@ of System address 
space create ECB 


Record 20 


Record 30 





Wa] Jo Aysadoig — speiiajeyy, posusory 


«AGI JO SpetsayeyA] paysi4}s2y,, 


L861 ‘7861 “Hop Way wauAdoy @ y-Q0ZI-8ZAT 


uoiesadp jo poujapy “Ss YONI 


6¢9°S 


C 


Diagram 84. System Management Facilities Initialization Router (IEEMBS820) Part 2 of 2 


Extended Description Module Label 


This module starts the SMF address initialization process 

during Master Scheduler initialization. Once tha address 

space is initialized, IEEMB820 links to IEFSMFIE to start }1EEMB820 
interval accounting for the mastér address space. 


1 |EEMB820 sets up the SMF address space attributes 

by filling in the system address space list (EATTR). 
SMF is a high-priority address space (EATTRTYP) that 
cannot be swapped out. The SMF address space can be 
forced (EATTFRCE=1). IEEMB820 also sets up SMF 
address space parameters. Specifying IFASTART as the 
SMF address space initialization routine. 


2 \IEEMB8Z20 links to the system address space create |EEMB820 
routine to set up the SMF address space. |EEMB881 

sets a return code in register 15 and places the address of 

the address space initialization ECB in register 2. If the ad- 

dress space create fails, |EEMB820 issues message IEE4801 

to notify the operator. 


3  $IEEMB820 waits on the ECB returned by IEEMB881. 1EEMB820 
IFASTART posts this ECB when initialization is com- 
plete so that |EEMB820 can continue. 


4 ~sIf SMF recording is being used, |E EMB820 starts in- IEFSMFIE 
terval accounting for the master scheduler address space 


by linking to the SMF initialization exit routine. 
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SMF 
Keyword Meaning and Use 
ACTIVE Specifies whether or not SMF 
recording is to be active. 
NOACTIVE 
DSNAME Specifies a list of up to 36 
(data set) VSAM data sets that are to 
be used for SMF recording. 
JWT Specifies the maximum amount 
(hhmm) of time that a job is allowed to 
wait continuously. 
LISTDSN Specifies whether the system is 
to generate SMF data set status 
NCLISTDSN messages to the operator at 
IPL and SET SMF time. 
MAXDORM Specifies the amount of time 
(mmss) that data is permitted to 
NOMAXDORM 7 remain in an SMF buffer before 
it iswritten to a recording 
data set. 
PROMPT Specifies whether the selected 
(option) SMF parameters are to be 
displayed on the system console 
at IPL time. 
NOPROMPT 


REC (option) Specifies whether information 
for record type 17 (scratch 
data set status) is to be 


collected for temporary data 


sets. 
(system) § Specifies the system identifier 
SID < (model, to be used in all SMF records. 
serial #) 
STATUS Specifies the amount of time 
{hhmmss) between creations of record 
type 23 (SMF statistics). 
NOSTATUS 
SYSloptions) Specifies the global recording 
options for the entire system. 
SUBPARM Specifies the information to 
(name be passed to a specific subsystem 
(parameters)) 
SUBSYS Specifies what data is to be 
(name, collected and recorded for a 
options) specific subsystem. 


Possible Values 


SYS1.MANn where 


n=A-Z, 0-9 


0001-2400 


0001-5959 


ALL 
IPLR 
LIST 


ALL 
PERM 


The system 

and the model 
on which SMF 
is active and the 
processor 

serial #. 


00000 1-240000 


See Figure 5-6 
for a list of 
Options. 


Subsystem name 
followed by any 
parameters 


Subsystem name 
foilowed by any 
of the options 


listed in Figure 5G 


Default 
ACTIVE 


DSNAME 


(SYS1.MANX, 


SYS1.MANY) 


JWT (0010) 
[10 minutes] 


LISTDSN 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Corresponding Field in SMCA 
SMCAMAN=1, SMCAUSER=1 


SMCAMAN=0,SMCAUSER=0 


SMCAFRDS, SMCALRDS, 
SMCASVCR, SMCASRBR 


SMCASJWT=‘hhmm’, 
SMCAJWT=hhmm 


SMCALDSN=1 


SMCALDSN=0 


MAX DORM(3000) SMCAMXDM=1, SMCASMDM='mmss’ 


[30 minutes] 


PROMPT(ALL) 


REC(PERM) 


The processor 
model number 
found in the 
PCCA control 
block. 


STATUS 
(010000) 
[1 hour} 


See each option 


None 


See each option 


SMCAMXDM=0, SMCASMDM=‘0000' 
SMCAMAXT=0 

SMCAMXT=address of timer element 
SMCAIPLR=1, SMCALIST=1 
SMCAIPLR=1, SMCALIST=0 
SMCAIPLR=0, SMCALIST=1 


SMCAIPLR=0, SMCALIST=0 


SMCATDS=1 
SMCAT DS=0 


SMCASID=system 


SMCAST US=1, SMCASSTS=‘hhmmss’ 
SMCASTTT=address of timer element 


SMCAST US=0, SMCASSTS='000000' 
SMCASTTT=0 


SMCASY SP=address of SYS SST 
entry 


SMCASUBP points to a chein of control 
blocks. Each control block identifies 
one subsystem name and its parameters 


SMCASSTD points to the block of 
SSTs. 





Figure 5-5 The Relation of System Management Facilities (SMF) Keyword Parameters! to Fields in SMCA 


1 For more information of SMFPRMxx parameters, see System Management Facilities (SMF) 
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SMF 
Keyword Meaning and Use Possible Values Default. Corresponding Field in SST 
TYPE TYPE specifies the record types 0-255 TYPE(0:255) SSTRCDON — 256 bits string with bits 
(aa,bb...) to be collected by SMF. turned on for only those record types 
° NOTYPE specifies that all requested. 

records except those specified 

are to be written by SMF. . 
NOTYPE y 0-255 SSTRCDON ~— 256 bit string with all 
(aa,bb.. .| bits turned on except for those record 

types requested. 

DETAIL Specifies the level of data — SSTDETAL#=1 

collection for type 32 TSO 

records. 
NODETAIL _— NODETAIL SSTDETAL=0O 
INTERVAL Allows the user to checkpoint 000001-240000 NOINTERVAL SSTINTVL=interval in 64-bit form 
(hhmmss) accounting data during the 

course of a long running job 

or TSO session by specifying 

the amount of real time 

between each checkpoint. 
NOINTERVAL SSTINTVL=0 
EXITS(exit Specifies whether SMF exits — EXITS SSTEXTAB=address of EXITTAB 
name, exit are to be invoked. (Table contains up to 15 exits. 
name...) EXITINAC (i)=1 if exit {i) is inactive.) 
NOEXITS _ SSTEXTAB=address of EXITTAB 


{Any exits specified previously will 
have EXITINAC {i)=1.) 


Figure 5-6 The Relation of System Management Facilities (SMF) Keyword Parameters to Fields in the 


Subsystem Selectivity Table (SST)! 


1 an SST entry is created for SYS and for each SUBSYS specified during IPL and subsequent SET commands. 
Any SUBSYS parameters not specified default to the corresponding SYS parameter currently in effect. 
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Diagram 85. Recovery Termination Management Initialization (IEA VIMS1),Part 1 of 4 
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Diagram 85. Recevery Termination Management Initialization (IEAVTMSI) Part 2 of 4 


Extended Description Module Label 


Recovery termination management initialization is invoked 
from master scheduler region initialization (IEEMB860) 

to establish three permanent tasks. These tasks handle 
requests for writing records to SYS1.LOGREC or to the 
operator, requests for scheduled SVC dumps of the master 
scheduler’s address space, and requests for address space 
termination. Each task performs its ofvn initialization, 
notifies IEAVTMSI when initialization is complete, and 
then waits for a request. 


1. When each task is attached, it must have the address IEAVTMSI 
of an initialization ECB (event contro! block). 

IEAVTMSI places the address of an initialization ECB in 

register one for each of the three tasks. (These ECBs are 

also used as end-of-task ECBs should one or more of the 

attached tasks abnormally terminate before its initializa- 

tion is complete.) Each task posts its ECB when it com- 

pletes its initialization. When all three tasks are attached 

and initialized, they are ready to process and will wait for 

a request to do so. 


Extended Description Module Label 


2 ~=«‘The asynchronous recording task performs initializa- IEAVTRET 


tion as follows: 


e Initializes the SRB in the RBCB (an SRB created by 
IEAVNPAG via the GETMAIN macro instruction). 


e Obtains storage (GETMAIN) in subpool 252 for a work 
area containing recovery tracking information. 


e issues an ESTAE macro instruction to set up the recovery 
environment for the recording task. 


When there is a request to write records to SYS1.LOGREC 
or to the operator, the SRB just created notifies the record- 
ing task to process the request. The recording request rou- 
tine, located in the nucleus, schedules this recording task 
SRB (RBCBEUB) which posts the recording task ECB. 

The recording task then issues an SVC 76 to write to 
SYS1.LOGREC or issues a WTO to write to the operator. 
System routines running in supervisor state with a pro- 
tection key of zero can use the recording task for 

writing to the operator. 


3. SVC dump task initialization creates an ECB that is 
posted when a system routine requests a scheduled 

dump of the master scheduler’s address space. An SVC 

dump task is normally attached and initialized by the region 

control task (RCT) for each address space. However, the 

SVC dump task for the master scheduler’s address space 

is attached by IEAVTMSI. For a general discussion of this 

task, refer to the topic “SVC Dump Task" in 

System Logic Library.' 


IEAVTSOT 
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Diagram 85. Recovery Termination Management Initialization ((IEAVTMSI) Part 3 of 4 
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Diagram 85. Recovery Termination Management Initialization (IEAVTMSD Part 4 of 4 


Extended Description Module Label 


4 = Address space termination task initialization creates IEAVTMTC 
a workspace containing recovery tracking information, 

an RSM parameter list, and an SRB. IEAVTMTC also fixes 

the pages of IEAVTMTC {including ESTAE exit code) and 

issues the ESTAE macro instruction to set up a recovery 

environment. Finally, IEAVTMTC allows the termination 


SRB to be scheduled by setting a flag (RTC TMLCR=1). 


A request for address space termination causes the address 
space termination SRB to be scheduled. This termination 
SRB then notifies the address space termination task to 
process the request. The termination task, when posted 
for work, processes address space termination requests. 

It uses the recovery tracking information to retrace its 
steps if a program check occurs while it is terminating 

an eddress space. The termination task passes the RSM 
parameter list to a real storage management routine. This 
routine frees all pages and frames allocated to the termina- 
ting address space. 


= 


Extended Description Module Label 


5 IEAVTMSI waits for the three tasks attached in steps IEAVTMSI 
2, 3, and 4 to post the ECBs passed to them through 

register one. It then frees the space obtained in step 1. The 

three initialization ECBs remain to serve as end-of-task 

ECBs. Control is then returned to master scheduler region 


initialization (IEEMB860). 


Error Processing 


IEAVTMSI runs in an ESTAE environment. If the ESTAE 
exit is taken, it will pass a return code of 4 to master 
scheduler region initialization. if IEAVTMSI is posted by 
any of the three tasks with a completion code other than 
zero, it will pass a return code of 4 to region initialization. 
A return code of 4 causes region initialization to terminate 
the initialization. 


Each of the three attached tasks sets up its own ESTAE 
environment during its initialization phase. This environment 
allows the task to attempt recovery if it fails while process- 
ing a requast. If any of these three tasks fails before its 
initialization phase is complete, the ESTAE routine that 
receives control will cause the abnormal termination to 
continue, thus causing the end-of-task ECBs to be posted. 
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Diagram 86. Auxiliary Storage Mangement Initialization (ILRTMI00) Part 1 of 4 


From 
ILRTMRLG 
Input Process 


1 Obtain resources. 


Register 3 


eel 
ASMPART PARTTPAR 
a ee 


TPARTBLE 


1/O buffer 


2 Open SYS1.STGINDEX if 
Request parameter CVIO is specified. 


list (RPL) 


For 8 warm start, open 
SYS1.STGINDEX and use 


PARTE it to restore VIO data sets. 


PAREBPF Perform cached auxiliary 
storage subsystem 
processing. 








Output 


ASMVT 


ASMPART 


og 
¢ 
= 
= 


ASMVSC 
ASMSTGXA 


H 
© 
ec] 


timestamp 


fo 
z 
= 
e 


PART 


PARESLTA 
PAREPATP 


PATMAP 


Request parameter 


list (RPL) 
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Diagram 86. Auxiliary Sterage Mangement Initialization (ILRTMI100) Past 2 of 4 


Extended Description Module Label 


ILRTMI00 completes the initialization process for ASM. It 
dynamically allocates, opens, and uses SYS1.STGINDEX: it 
builds and optionally displays the data set name list for all 
page and swap data sets; it backs the master scheduler ad- 
dress space with one megabyte of storage. I|LRTMRLG, 


which is attached by |EEMB860, invokes ILRTMIOO. ILRTMIOO 


1 ILRTMIOO issues the GETMAIN macro instruction to ILRTM!IOO  INITTMI 
obtain storage from subpool 241 for an 1/O buffer and 

an RPL (request parameter list) buitd area. |LRTMIOO issues 

another GETMAIN macro instruction to obtain storage for 

an ACB from subpool 245. | LRTMIOO dynamically allocates 


the SYS1.STGINDEX data set. 


2 If the TPARTBLE warm-start flag is off ILRTMIOQ CVIOSTRT 
(TPARWARM=‘0’), ILRTMIOO performs CVIO pro- 


cessing. 


a. |ILRTMIOO issues a GENCB macro instruction to build 
the ACB for SYS1.STGINDEX. 

b. ILRTMIOO issues an OPEN macro instruction with the 
reuse option to reclaim all of SYS1.STGINDEX. 

c. ILRTMIOO copies the timestamp (TPARTIME) from the 
TPARTBLE to the I/O buffer. I|LRTMIOO issues a 
GENCB macro instruction to build the RPL and then 
writes record zero of SYS1.STGINDEX. 

d. ILRTMIOO issues a CLOSE macro instruction for 
SYS1.STGINDEX; then reopen SYS1.STGINDEX for 
updating. 


3 ~3=soIf the TPARTBLE warm start flag is on WARMSTRT 
(TPARWARM='1'), ILRTM!IOO performs warm start 


processing. 


a. |{LRTMIOO issues a GENCB macro instruction to build 
the ACB for SYS1.STGINDEX. 

b. ILRTMIOO opens and updates SYS1.STGINDEX. 
|LRTMIOO issues a GENCB macro instruction to build 
the RPL. |LRTMIOO issues a VERIFY macro instruction 
to update the VSAM catalog. 


ILRTMIOO 


Extended Description Module Label 
3. (continued) 


c. ILRTMIOO reads in the records from SYS1. STGINDEX. 
These records identify slots used for VIO data sets from 
the previous IPL. For each VIO data set, |LRTMIOO 
calculates the actual slots used by the VIO data set (to 
update ASMVSC). While reading these records, 
{LRTMIOO marks the slot in the appropriate local page 
data set‘s PAT (bit map of slots) as unavailable and up- 
dates the available slot count for this local page data 
set (PARESLTA). 


|LRTMIOO checks for VIO slots on unavailable local paging 
data sets. If any VIO slots were on local paging data sets 
and the data sets are not available for this IPL, then the 
warm start fails and a quick start is forced. 


4  ILRTMIOO scans all the PARTEs. If any data sets are 
on a cached auxiliary storage subsystem, ILRTMIO0 
does the following: 


e Page fixes |LRTMI1OO to obtain the ASMLG lock. 


e Obtains the ASMGL lock to serialize the manipulation 
of the PART and PARTEs. 


e For a PARTE associated with a PLPA, common, or 
duplex data set, rechains the paging-mode IORB as the 
current |ORB chain. 


e Fora PARTE associated with a page data set, sets the 
PARESPP field to cause paging-mode to be used for I/O 
to the paging subsystem. 


e Releases the ASMGL lock. 
e Page frees |LRTMIOO. 


@ Turns off the warm start invalid bit (TPARTRAP) in 
the TPARTBLE. 


e Writes out the TPARTBLE. 
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Diagram 86. Auxiliary Storage Mangement Initialization (ILRTMI00) Part 3 of 4 


Input Process Output 





ASMVT 







ASMSART 
ASMPART 







ASMSART 
ASMPART 






5 Build the data set name list. 


G Set other ASMVT counts |] 


and indicators. 





PARTTPAR 


TPARTBLE 


ASMCINV 


ASMNOLCL 
ASMREQCT 






0 
© 
cE © 
8 
: 
® 
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PART 


PARTDSNL 





7 Issue the ASM messages 
that have accumulated. 






ASM mes ASM messages 

nodule Ey) during NIP 
processing 

8 Release resources. 






Return to 
ILRTMRLG 





SART 


SARDSNL 
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Diagram 86. Auxiliary Storage Mangement Initialization (ILRTMI00O) Part 4 of 4 


Extended Description Module Label 


5  ILRTMIOO adds the total number of possible page and ILRTMIOO BUILDSNL 
swap data sets and issuesa GETMAIN macro instruction 

for subpool 241 storage for the data set name list. [LR TMIOO 

copies the local page data set names from the TPARTBLE 

to the data set name _|ist. [LR TMIOO puts the address of 

the list in the PART. Copy the swap data set names from 

the TPARTBLE to the last section of the gata set name 

list. ILRTMIOO also puts the address of this portion of the 

data set name list in the SART. 


G6 ILRTMIOO sets the ASMREQCT field to two, allowing 
the group operator starter routine of ASM to make 
only two simultaneous requests to VSAM. ILRTMIOO 
also sets the ASMCINV fleld equal to the number of control 
intervals in SYS1.STGINDEX (that is, the maximum number 
of records allowed). Now that VIO slots are currently 
marked unavailable (step 3). {LRTMIOO sets the 
ASMNOLCL bit off; this action allows slots to be allocated 
to local page data sets. 


ILRTMIOQO 


Extended Description Module Label 


7 ~_ILRTMIOO invokes the |LRMSGSFP entry point of 
|LRMSGOO to write out any ASM messages queued 
during NIP processing. 


ILRMSGOO_ ILRMSGSP 


8  ILRTMIOO issues a FREEMAIN macro instruction to 

free the |/O buffer RPL build area, the TPARTBLE, 
and the page storage table. |LRTMIOO then returns to the 
caller. 


ILRTMIOO 


Recovery Processing: 


Allrecovery for ILRTMIOQ is handled by module!ILRTMIO1. 
ILRTMIO1 is an ESTAE established by |LRTMRLG to pro- 
tect itself and those modules it calls, one of which is 
ILRTMIOO. [LRTMIOT retries ILRTMIOO at one of three 
retry points. 


|LRCRTM2 — used if activating warm start processing fails. 
ILRCRTM3 — used if starting CVIO processing fails. 
ILRCRTM4 — used if building data set name lists fails. 
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Diagram 87. Subsystem Initialization (IIEFJSIN2) Part 1 of 8 


Master Scheduler Initialization (JEEMB860) Ls 
Diagram 63, Step 25 







1 Establish a recovery 
environment. 










Build the parameter list 
to read the parmlib 
record. 









2 a. 

















Read parameter list 


SSN Suffixes 


Parmlib 
read 
routine 





console id 


4 buffer 


member name 








Record in |EFSSNxx 


SSNAME, INIT RTN, PARMS, 
PRIMARY, NOSTART 
Comment 
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Diagram 87. Subsystem Initialization (IIEFJSIN2) Part 2 of 8 
Extended Description Module 


IEFJSIN2 initializes the subsystems identified in the 
IEFSSNxx members of SYS1.PARMLIB. If IEFSSNxx 
members are missing, IEFJSIN2 issues a message explaining 
this condition. IEFSSNxx contains two keywords: 
PRIMARY and NOSTART. PRIMARY allows the install- 
ation to specify a primary subsystem name and NOSTART 
indicates that the primary subsystem should not be auto- 
matically started. To specify NOSTART, you must specify 
PRIMARY. 


Also IEFJSIN2 uses the subsystem service routine 
(IEFJS8LD} to rebuild the subsystem allocation sequence 
table (SAST) and to build the hash table (SHAS) of SSCVT 
addresses. 


1 Establish the ESTAE environment. 


2 The master scheduler resident data area (MSRDA) IEFJSIN2 
points to the scheduler NIP parameter list (SNPL). If 
the SNPL indicates that there are any IEFSSNxx parmlib 
members to process (SNPSSN&*O), then IEFJSIN2 performs 
steps 2a-2e for each record in each IEFSSNxx parmlib 
member. After all members are processed, control passes to 
step 2f. The SSN parameters are in the format, Nxxxx... 
where N is the number of parmlib members and each xx is a 
two character suffix appended to IEFSSN that identifies a 
particular parmlib member. If there are no IEFSSNxx 
parmlib members to process (SNPSSN=0), go to step 7. 


a. Call the parmlib read routine, |EEM8878, to read an 80- JIEEMB878 
byte parmlib record. The input parameter list to 
IEEMB8878 must contain a console id to which messages 
can be issued, the address of an 80-byte buffer, and the 
name of the parmlib member to be read. 
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Diagram 87. Subsystem Initialization (IIEFJSIN2) Part 3 of 8 


Input Process _ Output 





2 (continued) 






b. Perse the record. 









IEF SSNxx parmiib record 









\EEMBS882 


Positional 


parser 
routine 
: S Answer area 
fice | Parmlib record 






Rules list 





= 
v0 
; . 








c. For an invalid record, 
issue an error message. 





invalid record 









d. Validate the subsystem 
name. 





IEFSSNxx parmlib record 





Message = [| "1 Message IEF 7601 


writer 


invalid name 











Xap go Aysadoig — syetuayeyy pasuaory| 


IKE J9 SFEMIIEPL PIJIIAjSI YZ, 


L861 ‘7861 ‘ds0D WAI Wahdoy @ -00Z7I-8ZAT 


UoleladyO Jo poyyapy “s uOTIaSg 


tP9o-s 


C 


Diagram 87. Subsystem Initialization (IIEFJSIN2) Part 4 of 8 


Extended Description Module Lebel 
2 (continued) 


b. Stora the address of the parmlib record and the rules list IEEMB882 PLIBPROC 
in the input parameter list to IEEMB882, the positional 
parser routine. Invoke IEEMB882 to check the syntax 
of the parmlib record. IEEMB882 verifies that the 
parameters on the record comply with the rules list for 
such items es the number of parameters on the record, 
the minimum and maximum length of each parameter, 
whether the parameter is optional or mandatory, and 
whether the parameter can be enclosed in apostrophes. 
(For a description of IEEMB882 see MVS System 
Logic Library.) 


c, If the return code from IEEMB882, located in the IEFJSIN2 PLIBPROC 


answer area of the positional parser parameter list 
(PIPL), indicates either that an invalid parameter exists 
or that there are too many parameters in the record, cell 
the message writer, IEF JSIMW, passing the console id, 
the number of lines in the message, and a pointer to the 
message data for message IEF 7601. The message indi- IEF JSIMW 
cates that the parmlib record is in error and includes the 
first 70 bytes of the record in error. After issuing the 
message continue processing at step 6a to process the 
next parmlib record. If the parmlib record is valid, 
proceed to step 6d. 


Extended Description 


d. Varify that the first charactar of tha subsystem nama is 
an alphabetic or national character and that the remain- 
ing characters are alphameric or national characters. If 
the subsystem name is not valid, invoke the message 
writer, IEF JSIMW, to issue message IEF 7601. After issu- 
ing the message, continue processing at steps 6a to 
process the next parmlib record. 


if the subsystem name is valid, proceed to step Ge. 


Module 


IEF JSIN2 


(EFJSIMW 


i abel 


VALSSNME 
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Diagram 87. Subsystem Initialization (IIEFJSIN2) Part 5 of 8 


Input 





Process 








2 e. If the PRIMARY keyword 
was previously specified, 
issue an error message. 







invalid record 





If invalid data is encount- 
ered instead of PRIMARY 
or NOSTART, issue an 
error message. 












IEFJSIMW 


message 
writer 





IEF JSIMW 


message 
writer 


i | ‘if 


Output 






=>) 


message |EF735! 


message !EF737] 


a aed 
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Diagram 87. Subsystem Initiahzation (IIEFJSIN2) Part 6 of 8 


Extended Dascription Module Label 


e, 


If the PRIMARY keyword is specified, determine if 
JESPJESN contains zeroes indicating it is not initialized. 
If it does, initialize JESPJESN with the primary sub- 
system name spcified in the IEFSSNxx member. If it 
does not contain zeroes, indicating it is initialized, in- 
voke IEFJSIMW to issue message IEF735I1. This message 
indicates that PRIMARY has been previously specified. 


If invalid date is encounted in place of the PRIMARY or 

or NOSTART keywords, invoke IEFJSIMW to issue mes- JEFJSIMW 
sage IEF 7371. This message indicates that unrecognized 

data was encountered and that it is ignored. 
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Diagram 87. Subsystem Initialization (IIEFJSIN2) Part 7 of 8 


Input Process Output 
2 = (continued) 
SSPL 


g. Build the SSCVT and 
initielize the subsystem. SSPSSCT=1 
SSPINIT=1 
f Initialization 
ques routine name 


oat ter 
routine oat ter 






lEFJSBLO 


Subsystem 
service 





routine 





- 


h. Free the SSN suffix tist. 


i. If a primary subsubsytem name is 


not specified, issue.a prompt to 
specify one. message IEF736A 










3 Create a hash table and, if 
needed, a SAST. —- 
IEFJSBLO | SSPSAST=1 
Subsystem rr 
service 
routine 
SHAS 
4 Delete the recovery SAST 
Return to 
caller 





Cc 
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Diagram 87. Subsystem Initialization (IIEFJSIN2) Part 8 of 8 


Extended Description Module Label 
2 (continued) 


g. Initialize the parameter list to indicate that an SSCVT IEFJSIN2 PLIBPROC 
be built and that the subsystem initialization routine get 
control via a LINK macro instruction. Include the address 
of the initialization routine name and the address of 
initialization routine parameters that were obtained from 
the parmlib record. Then call IEFJSBLD. After IEFJSBLD 
\EFJSBLD returns, proceed back to Ga to process the next 
parmlib record in IEFSSNxx. 
h. Issue a FREEMAIN macro instruction for the SSN suf- IEFJSIN2 FREESSN 
fix list. 
i. Ifa PRIMARY keyword is not specified, issue message 
1EF736A which prompts the system operator to name 
a primary subsystem. 


3 .~—sInitialize the parameter list to indicate that a subsys- IEFJSIN2 BLOTABLS 
tem hash table (SHAS) and, if additional subsystems 

were specified in parmlib, a subsystem allocation sequence 

table (SAST) needs to be built. The hash table contains 

SSCVT addresses; it is used by the subsystem interface to 

locate SSCVTs. (The SAST is used in the allocation of sub- 

system data sets.) Invoke IEFJSBLD to build the SAST. IEF JSBLD 


4 Return to the caller of IEFJSIN2, master scheduler 
initialization (IEEMB860), after deleting the ESTAE 
environment. 


Recovery Processing 


If RTM invokes the ESTAE recovery routine as a result of 
an error in IEFJSIN2, the ESTAE recovery routine: 


e@ Re-establishes the code and data registers. 

@ Requests retry unless a previous retry attempt was 
made, the error is a percolated one, or the error is a 
machine check; in these cases, the ESTAE requests 
RTM to continue termination. 

@ Records appropriate diagnostic information in the vari- 
able recording area of the SDWA. 

@ Takes an SDUMP only if the error is not a machine 
check or percolated error. 


The retry routine cleans up IEF JSIN2 processing and issues 
message |EF 7581 to inform the operator thet an ABEND 
occurred during subsystem initialization. 
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Diagram 88. Display Allocation Scavenge Routine (IEFHB412) Part 1 of 2 


Master Scheduler Initialization 


(1EEMB860), 
Process 


Input 





1 Establish a recovery 
environment. 





CVTJESCT 





2 Ensure that the allocation 
address space (ALLOCAS) 
was created. 





JESALLOA 


3 Close out the unit 
selection. 


_—_————— 
UCBALOC 
a == =| 







4 Update the DALT use 
counts to reflect what 






UCBUSER ; 
UCB is associated 
poe 0g ee ll m 
with what ASID. 
UCB3DACC 
——ESE Ea 
UCBASID 









5 Allow unit selection and 
cancel the recovery 
environment. 








1EEMB860 


Output 
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‘DALT’ 
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Diagram 88. Display Allocation Scavenge Routine (IEFHB412) Part 2 of 2 


Extended Description Module Label 


The display allocation scavenge routine (1EFHB412) 

scans all the UCBs in the system and associates the 
allocation use count in each UCB with a particular address 
space or a number of address spaces. 


1 Set up an ESTAE environment. [EFAB4EGE is IEFHB4I2 ESTAPROC 
the ESTAE. 
2 Check the JESALLOA field in the JESCT to IEFHB412 


determine if the allocation address space (ALLOCAS) 
was created. If it has not been created, then set a return 
code of 8 and return to the caller. 


3 Otherwise, issue an ENQ macro instruction to request [EFHB412 
shared use of the SYSZTIOT resource and 

exclusive use of the Q4, DDRTPUR, and DDRDA 

resources. 


4 Scan the UCBs using IOS scan service (IOSVSUCB). IEFHB4I2 SCAVENGE 
Assign all allocated non-direct access devices to the 
diaplay allocation lookup table (DALT) for the ASID found 
in the UCB field UCBAS!D. For ali other allocated UCBs 
(that is, those in use), determine what use count is already 
stored in the DALTs. If the use count is zero, then store 
a one in the use count field of the DALT. Add the difference 
to the DALT for the pseudo ASID, ASID 0. (ASID O is the 
peeudo ASID for a DALT that contains system-related 
allocation counts.) Note that all references and updates to 
the DALTs are made by issuing a program call (PC) to 
1EFHB410, the display allocation tables manager. 


5 _—s&Release the resources acquired in step 3 by issuing IEFHB4I12 
a DEQ macro instruction. Cancel the ESTAE 

environment and return to the caller. 

Recovery Processing 


See Diagram 70 for information on recovery processing. 
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SECTION 6. MODULE DESCRIPTIONS 


IPL RIMS 
IEAVNIPLOO Knows a RIM by the name "'IEAVIPLxx', where ‘xx' is 
the entry in the suffix list. This name might be an entry point 
of a module that has a different name. The following table 


gives the names of the RIMs in order of invocation, the module 
name, and the corresponding component. 


CREW Name [ Component Hane 

rrearruso | 10s 
Control 

rearrios [10s 
















LY28-1200-4 (c) Copyright IBM Corp. 1982, 1987 Section 6. Module Descriptions 6-1 


"Rastricted Materials of IBM" 
Licensed Materials — Property of IBM 


NIP RIMS 





entry in the suffix list. This name might be an entry point of 
a module that has a different name. The following table gives 
the names of the RIMs in order of invocation, the module name, 
and the corresponding component. If there 1s no entry under 
Module Name, the RIM Name and the module name are identical. 


Tra ae [vote ane | Comparer tame 

Tremwes [| service Preoessor 

Crenweas [ete 
IEAVNPO6 MCH 


IEAVNIPM knows a RIM by the name 'IEAVNPxx', where 'xx® is the ) 











IEAVNPE8 IARMU 
Centry 
point 
IARMURIM) 





IEAVNP23 ISGNCBIM Global resource 
serialization 


IEAVNPA2 IEAVNPO2 IOs 
Centry 
point 
IEAVNPA2) 
IEAVNPB2 IEAVNPO2 Ios 
Centry 
point 
IEAVNPB2) 


IEAVNPO4 ILRASRIM 


IEAVNPA8& IEAVNPO8 VSM 
Centry 


point 
IEAVNPA8 ) 


IEAVNP14 ILRASRM1 
IEAVNP25 Supervisor control 


IEAVNPOS5 Contents supervisor 
IEAVNPB8 IEAVNPO8 VSM 








Centry 
point 
IEAVNPB8) 
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RIM Name Module Name Component Name 


IEAVNPO9 
IEAVNPD8 


Supervisor control 





ITARMNRIM) 
IEAVNP10 
IEAVNPIF 


IEAVNPDI IEAVTABI ABDUMP 


IEAVNPD2 IEAVTSDI SVCDUMP 


Centry 
point 
IEAVTSDI) 





IT EAVNPX1 
IEAVNPFS5 
IEAVNP51 System trace 


ITEAVNP3S3 ISGNTASC Global resource 


PC/AUTH 


serialization 
w TEAVNP57 
IEAVNPAL 
ITEAVNP16 Data management 


LEAVNP13 bo ee Mactan echeduler 


Dumping services 


Communications task 


IEAVNP17 
ITEAVNP18 
JTEAVNP19 


IEAVNP20 io OU Content. <aneruicor 


IEAVNPF2 | =s———s|:‘0 

LEAVNP15 Allocation 
IEAVNPIB | = ss 

IEAVNPOO td Reconfiguration 


ITEAVNIPX NIP 
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IARMF Centry point IARMFRIM) ~~ RSM Extended Storage Control Block Routine 
OPERATION: Builds and initializes extended storage control 
blocks and queues that RSM uses to control any extended storage 
that might be configured in the system. IARMFRIM is in load 
module IEAVNPD8. 

ENTRY FROM: IEAVNPD8 


EXIT: Returns to the caller. 





IARMI (entry point IARMIIPL) —~ RSM Initial Program Loader 
OPERATION: Initializes the page frame table (PFT) and the RSM 
address space block (CRAB), and maps the existing segment table 
into ELSQA and the existing page tables into ESQA and ELSQA. 
IARMIIPL 18S in load module IEAIPLO6. 
ENTRY FROM: IEAIPLOO 


EXIT: Returns to the caller. 


IARMN Centry point IARMNRIM) -—— RSM Initialization Routine 
See the module description for IEAVNPD8. 


IARMS Centry point IARMSRIM) =~ RSM System Parameter Routine 


OPERATION: Completes processing of the REAL and VRREGN system 
parameters. 


ENTRY FROM: IEAVNPD8& 
EXIT: Returns to the caller. 





IARMT (Centry point IARMTRIM) —~ RSM RSU Parameter Routine 
OPERATION: Processes the RSU system parameter. 
ENTRY FROM: IEAVNPD8& 
EXIT: Returns to the caller. 


IARMU Centry point IARMURIM) ——~ RSM REAL Parameter Routine 


OPERATION: Sets up an initial V=R region for the REAL 
parameter. 


ENTRY FROM: IEAVNIPM 
EXIT: Returns to the caller. 


IARVB (entry point IARVBCSG) ——~ RSM Create Segment Support 


OPERATION: Creates a segment of common storage by formatting a 
page table for that segment. 


ENTRY FROM: IEAVNPA&, IEAVNPB8. 
EXIT: Returns to the caller. 
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IARXT Centry point IARXTIGU) ~~ RSM Contiguous Real Support 


OPERATION: Backs the virtual range specified by VSM with 
contiguous preferred real storage. 


ENTRY FROM: IGVNIPCR. 
EXIT: Returns to the caller. 


IEAIPLOO — Initial Program Loader 
OPERATION: Clears real storage and registers, prepares an 
environment in which the IRIMS can execute, provides a set of 
common service routines for the IRIMs, and finds, passes control 
to, and deletes the IRIMs. 


ENTRY FROM: The operator when he or she activates the load 
process. 


EXIT: IEAIPLI9S. 
ERROR EXIT TO: System wait state. 


IEAIPLO1 —~ IRIM List 


OPERATION: List of IDs of IPL resource initialization modules 
to be loaded by IEAIPLOO. 


ENTRY FROM: Not applicable (Cnon-executable module). 


EXIT: Not applicable (non-executable module). 


IEAIPLO2 ——- Nucleus Load Routine 
OPERATION: Loads the DAT~off nucleus and the DAT-on nucleus. 
ENTRY FROM: IEAIPLOO. 
EXIT: Returns to the caller. 


IEAIPLO3 — Initializes UCB for System Resident Volume 
OPERATION: Initializes the UCB and subchannel for the device 
from which the system was IPLed, builds the resident ERP table 
and sets the DDI pointers in the UCBs. 
ENTRY FROM: JIEAIPLOO. 


EXIT: Returns to the caller. 


IEAIPLO4 -—~ Virtual Storage Management IRIM 
OPERATION: Allocates storage for the page frame tables, the 
system queue area (SQA), the extended SQA CESQA), and the 
extended local system queue area CELSQA). 
ENTRY FROM: IEAIPLOO. 


EXIT: Returns to the caller. 
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Nucleus Map Creation 


OPERATION: Creates a map of all modules and entry points in the 
DAT-on nucleus. 


ENTRY FROM: IEAIPLOO. 
EXIT: Returns to the caller. 


Real Storage Management IRIM 


SVC and 


Service 


OPERATION: Initializes the page frame table, the RSM internal 
table CRIT), the RSM address space block CRAB), and the RAB 
extension CRAX). 

ENTRY FROM: IEAIPLOO. 


EXIT: Returns to the caller. 


ESR Table Amode Bit Update 


OPERATION: Updates the AMODE indicators for nucleus resident 
SVC routines in the SVC and ESR tables. 


ENTRY FROM: IEAIPLOO. 
EXIT: Returns to the caller. 


Processor Interface Routine 


OPERATION: Invokes the SCP INFO functions of the service 
processor. 


ENTRY FROM: IEAIPLOO. 
EXIT: Returns to the caller. 


IPL Storage Validation Routine 


OPERATION: Validates the system storage and places all valid 
frames on the available frame queue. 


ENTRY FROM: IEAIPLOO. 
EXIT: Returns to the caller. 


IPL IRIM that loads the IPL WTO Facility Module 


IPL WTO 


OPERATION: Obtains storage for MQH (message queue header) and 
IEAIPL35, then loads IEAIPL35 into real storage. 


ENTRY FROM: IEAIPLOO. 
EXIT: Returns to the caller. 


(Write to Operator) Facility Module 


OPERATION: Places a message passed by the caller on the IPL/NIP 
message queue. 


ENTRY FROM: IPL resource initialization modules. 
EXIT: Returns to the caller. 


6-6 MVS/XA System Init Logic LY28-1200-4 (c) Copyright IBM Corp. 1982, 1987 


J 








"Restricted Materials of IBM" 
Licensed Materials — Property of IBM 


IEAIPLGO — Device Support Module List 


OPERATION: Builds the device support modules list. 
ENTRY FROM: IEAIPLOO 
EXIT: Returns to the caller. 


IEAIPLG1 — DAT-ON Nucleus Load Table Builder 


IEAIPL99 -—— 


ITEAVAP00 —— 


OPERATION: Builds a nucleus load list element for the DAT-on 
nucleus, prepares the nucleus load list for IEAIPLO2 to load the 
DAT-on nucleus into virtual storage. 

ENTRY FROM: IEAIPLOO 


EXIT: Returns to the caller. 


IPL Cleanup IRIM 


OPERATION: Performs IPL cleanup, allocates and initializes the 
address increment map CAIM), sets the prefix to the address of 
SYSGEN PSA, and transfers control to ITEAVNIPO. 

ENTRY FROM: IEAIPLOO. 


EXIT:  IEAVNIPO via LPSW. 


Volume Attribute RIM 


OPERATION: Sets status of permanently resident DASD volumes to 
public, sets status of devices without volumes to not-ready, and 
processes the volume attributes specified via the VAL system 
parameter. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


IEAVM200 ~=~ Generalized Message Service Module for SYS1.PARMLIB 


Processing 


OPERATION: Builds the requested message text for immediate 
issuance or for queueing. 


ENTRY FROM: IEAVN600, IEAVN601, IEAVN602, IEAVN610, IEAVN611, 
TEAVN612, IEAVN613, IEEMB888&, and IEEMB889. 


EXIT: Returns to the caller. 


IEAVNIPM ~~ NIP Control and Service Routine 


LY28-1200-4 


OPERATION: Initializes the NIP vector table (NVT); provides 
diagnostic support for software and hardware failures that occur 
during NIP before system recovery is available; finds, loads, 
and deletes NIP RIMs; finds and loads IEAVNIPX; contains the 
NIPOPIO, NIPPRMPT, NIPREAL, NIPSENSE, NIPSWAIT, and NIPUCBFN 
service routines; establishes initial operator communications 
and checks the operator's reply. 


ENTRY FROM: IEAVNIPO. 
EXIT: Returns to the caller. 
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IEAVNIPX —— NIP Exit Processing 
OPERATION: Deletes all NIP control blocks and all system traps. J 
ENTRY FROM: IEAVNIPM. 
EXIT: LINK to IEEVIPL. 





IEAVNIPO ~~ IPL/NIP Interface Routine 
OPERATION: Performs post-IPL housekeeping, allocates and 
initializes global system control blocks, and sets up an 
environment in which the RIMS can run. 
ENTRY FROM: IEAIPLOIQ. 


EXIT: JIEAVNIPM. 


IEAVNPA1 ~~ Communications Task RIM 
OPERATION: Verifies CON= system parameter and passes control to 
the front end processor for CONSOLxx member of SYS1.PARMLIB 
CIEAVN600). 
ENTRY FROM: IEAVNIPM. 


EXIT: Returns to the caller. 


IEAVNPA2 =~ Non-Direct Access Devices Initialization 


OPERATION: Initializes all subchannels and verifies paths to 
non-direct access devices. 


ENTRY FROM: ITEAVNIPM. 





EXIT: Returns to the caller. 


IEAVNPAS — Contents Supervisor APF Table Build 


OPERATION: Builds the APF table using user-defined and 
system-defined authorized libraries. 


ENTRY FROM: IEAVNPOS. 
EXIT: Returns to the caller. 


IEAVNPA6 —— System Recovery Initialization 
OPERATION: Initializes RIM for software recovery by 
° Initializing the RICT. 


° Acquiring a quickcell pool for RIM use. 
e Initializing the recording buffer for the RTM recording 
task. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 
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IEAVNPAS8 — SQA Parameter Initialization 
OPERATION: Processes the SQA parameter and builds the VSM 
control blocks and calls real storage management (RSM) to build 
page tables necessary to describe the new SQA and extended SQA 
storage. 
ENTRY FROM: ITEAVNIPM. 


EXIT: Returns to the caller. 


IEAVNPB2 — Direct Access Device Initialization 
OPERATION: Verify paths to non-virtual direct access devices. 
ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


IEAVNPB8 — CSA Parameter Initialization 
OFERATION: Processes the CSA parameter, builds the VSM control 
blocks, and calls real storage management (RSM) to build the 
page tables necessary to describe the new CSA and extended CSA 
areas. 
ENTRY FROM: IEAVNIPM. 


EXIT: Returns to the caller. 


IEAVNPC1 — NIP Console Initialization Routine 
OPERATION: Find a valid console in the NIP Console Table (NCT). 
ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


IEAVNPC2 — Input/Output Supervisor Initialization 
OPERATION: Verifies paths to mass storage system (MSS) devices. 
ENTRY FROM: IEAVNPI9. 
EXIT: Returns to the caller. 


IEAVNPC5 = Contents Supervision Extended PLPA Creation 


OPERATION: Creates the extended PLPA, EPLPA, and LPA directory. 
IEAVNPC5 ais only called on cold start processing. 


ENTRY FROM: IEAVNPOS. 
EXIT: Returns to the caller. 


IEAVNPC8 —— LPA and ELPA Page Table Initialization 
OPERATION: Calls real storage management CRSM) to build th 
page tables for LPA and ELPA and marks the space that a GETMAIN 
macro instruction assigned. 
ENTRY FROM: JEAVNPO5, ITEAVNPC5, and JEAVNPOG/ILRASRIM. 


EXIT: Returns to the caller. 
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IEAVNPDI1 ~~ ABDUMP Initialization Routine 


IEAVNPD2 — 


ITEAVNPD6 —— 


IEAVNPD&S — 


IEAVNPE6 —— 





OPERATION: Initializes the ABDUMP. See the module description J 
for ITEAVTABI. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


SVC Dump Initialization Routine 


OPERATION: Initializes the SVC dump. See the module 
descriptions for IEAVTSDD and IEAVTSDI. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


Task Recovery Initialization 


OPERATION: Completes the initialization for RTM by placing the 
branch entry address of SVC 60 in the CVT. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


REAL, VRREGN, and RSU Initialization 


Service 


CPERATION: Initializes RSM control blocks and processes the 
REAL, VRREGN and RSU system parameters. 


ENTRY FROM: IEAVNIPM. 





EXIT: Returns to the caller. 


Processor CALL SVC Initialization 


OPERATION: Initializes the software control blocks required 
when using the service processor CALL SVC to interface with the 
hardware's service processor. The control blocks initialized 
are the service processor control block (MSFCB) and its buffer, 
the service processor attention block (MSFAB) and its buffer, 
the service processor communication block (MSFKB) and its 
buffer, and a service processor recovery buffer. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


IEAVNPE8 — REAL Parameter Initialization 


OPERATION: Processes the REAL parameter, marks all the page 
frame table entries (PFTEs) for frames in the V=R region, and 
merks the address increment map entries CAIMES). 

ENTRY FROM: IEAVNIPM. 


EXIT: Returns to the caller. 
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IEAVNPF2 -—— Input/Output Supervisor RIM 


IEAVNPF5 —— 


IEAVNPM2 -—— 


IEAVNPM3 -— 


IEAVNPM4 —— 


IEAVNPMS —— 


IEAVNPST =~ 


LY28-1200-4 


Program 


OPERATION: Processes the IECIOSxx member of SYS1.PARMLIB; 
IECIOSxx specifies time intervals to be used by the missing 
interrupt handler (CMIH) when it scans UCBs for missing interrupt 
conditions. IEAVNPF2 also allows an installation to change the 
hot I/0 threshold or default recovery actions. 

ENTRY FROM: IEAVNIPM. 


EXIT: Returns to the caller. 


Call/Authorization RIM 

OPERATION: Causes the PC/AUTH address space to be initialized. 
ENTRY FROM: IEAVNIPM. 

EXIT: Returns to the caller. 


NIP WTOR and WTO Service Routines 


NIPOPEN 


OPERATION: Writes NIP messages to the master operator's 
console; for WTOR, reads the replies associated with the WTOR 
messages. 

ENTRY FROM: IEAVNIPM and NIP RIMs. 


EXIT: Returns to the caller. 


and NIPMOUNT Service Routines 

OPERATION: Provides a general direct access and tape device 
mount facility and a general direct access and tape data set 
open facility. 

ENTRY FROM: IEAVNIPM and NIP RIMs. 


EXIT: Returns to the caller. 


NIP SYS1.PARMLIB Member Read Routine 


OPERATION: Locates and reads text records of SYS].PARMLIB 
members. 


ENTRY FROM: IEAVNIPM and NIP RIMs. 
EXIT: Returns to the caller. 


NIP Console Attention Routine 


OPERATION: Posts the NIP Console Table ECB whenever the NIP 
console issues attention. Otherwise, the attention is ignored. 


ENTRY FROM: IOS when IOS has received an attention. 
EXIT: Returns to the caller. 


SVC Table Initialization for Program Products 


OPERATION: Determines if certain access methods or program 
products are installed and, if so, sets up the SVC table entries 
they require. 

ENTRY FROM: IEAVNPSS5 


EXIT: Returns to the caller. 
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IEAVNPS5 -——~ Supervisor Control SVC Table Initialization 


OPERATION: J 


1. Initializes the system and ESR SVC tables, resolving the 
entry point addresses of LPA-~resident SVC routines. 

2 Completes the installation of LPA-resident user-SVC routines 
specified in SYS1.PARMLIB member(s) IEASVCx~x. 

3. Calls IEAVNPST to perform SVC table initialization for 
program products. 

a) Sets any SVC table entries with unresolved entry point 
addresses to IGCERROR. 


ENTRY FROM: IEAVNPOS. 
EXIT: Returns to the caller. 


IEAVNPOO =~ Reconfiguration RIM 
OPERATION: Invokes IEAVRTOD to initialize the time-of-day (TOD) 
clock on the IPL processor, writes the 3081 console restart text 
to the console screen of the IPL processor, and invokes IEEVCPR 
to bring the non~-IPL processor online. 
ENTRY FROM: IEAVNIPM. 


EXIT: Returns to the caller. 


IEAVNPO3S ~~ System Parameter Analysis and SYS1.LINKLIB Initialization 
OPERATION 
e Opens SYS1.PARMLIB. 


e Analyzes and merges system parameters from the operator's 
console and IEASYSxx in SYS1.PARMLIB. 





e Opens SYSI1.LINKLIB and its concatenated data sets specified 
1n member LNKLSTxx of SYS1.PARMLIB. 


° Prompts the operator for new specifications of system 
parameters. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


IEAVNP04 = Auxillary Storage Management RIM, Part 1 
See the module description for ILRASRIM. 


IEAVNPO5 — Link Pack Area Initialization RIM 


OPERATION: Performs resource initialization for the Contents 
Supervisor at IPL time. It builds the pageable link pack area 
for cold start processing, the fixed link pack area and the 
modified link pack area. JIEAVNPO0O5 initializes the SVC table for 
the entry point addresses of type 3 and 4 SVCs and the extended 
router CESR). This module is also used, prior to the PLPA being 
initialized, in order to build the LPALST library concatenation. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 
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IEAVNPO06 ~~ Machine Check Handler RIM 


IEAVNPO8 -—— Virtual 


OPERATIGN: Initializes control registers 14 and 15 and the 
machine check handler control blocks for the IPL processor. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


Storage Management RIMS 
See the module descriptions for: 
IEAVNPA8&8 — SQA Parameter Process 


IEAVNPB&8 — CSA Parameter Process 
IEAVNPC8 —- LPA and ELPA Page Table Initialization 


IEAVNPO9 -— Supervisor Control RIM 


OPERATION: IEAVNPO9 does the following: 


0 Initializes the address space vector table CASVT) with the 
maximum number of address spaces (specified in the MAXUSER, 
RSVNONR, and RSVSTRT system parameters). 

@ Initializes an ASVT entry for each possible address space. 

e Initializes each ASVT entry reserved for non-reusable 
address spaces. 

© Initializes each ASVT entry reserved for START/SASI address 


spaces. 
e Builds the three available entry queues. 
e Initializes the address space first tables (CAFTs) and the 


address space second tables CASTs) for the maximum number of 
address spaces. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


IEAVNPLA =~ VSAM-Data-Set-Open Service Routine 


OPERATION: Constructs VSAM control blocks chained off the ACB 
for VSAM data sets and opens VSAM data sets. 


ENTRY FROM: JIEAVNPII. 
EXIT: Returns to the caller. 


IEAVNP1B ~~ Master Catalog Utility RIM 


OPERATION: Closes the system catalog by freeing storage used by 
the catalog control blocks, except that used for AMCBS. 


ENTRY FROM: IEAVNIPM, IEAVNP1]1, IEAVNP12. 
EXIT: Returns to the caller. 


IEAVNPI1F ~~ System Resources Management Channel Measurement Initialization 


OPERATION: Builds and initializes the SRM measurement 
functions. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 
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IEAVNP1O -—~ System Resources Manager RIM 


OPERATION: Initializes the system resources manager (SRM) using ) 
the APG, OPT, ICS, and IPS system parameters. 


ENTRY FROM: IEAVNIPM. 





EXIT: Returns to the caller. 


IEAVNP11 =~" Master Catalog Open RIM 


OPERATION: Locates the system catalog, then uses IEAVNPIA to 
open the system catalog. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


IEAVNP12 ~~ NIP LOCATE Service Routine 


OPERATION: Locates data sets that are cataloged in the system 
catalog. 


ENTRY FROM: IEAVNIPM, IEAVNPO3, IEAVNPO5, IEAVNP11, ILROPSOO. 
EXIT: Returns to the caller. 


IEAVNP13 = Master Scheduler Initialization Interface RIM 


OPERATION: Prepares the interface between NIP and master 
scheduler initialization by: 


® Obtaining the SMF system parameter values and storing them. 

O Obtaining the LOGCLS and LOGLMT system parameter values and 
storing them. 

o Storing the suffixes of the SSN members of SYS1.PARMLIB. 

O Reading the IEACMD00 and COMMNDxx members of SYS1.PARMLIB 
and storing the automatic commands. 

® Obtaining the suffix value for the MSTJCLxx member of 
SYS1.LINKLIB used to start the master scheduler address 
space. 


ENTRY FROM: ICAVNIPM. 
EXIT: Returns to the caller. 





IEAVNP14 -—— Auxiliary Storage Management RIM, Part 2 
See the module description for ILRASRM1. 


IEAVNP15 -——~ Volume Attribute RIM 
See the module description for IEAVAPOO. 


IEAVNP16 =~ Data Management RIM 


OPERATION: Builds table of user-written EXCP appendages that 
may be used by unauthorized programs, builds CVAF table, 
processes the RER and RDE system parameters. and branches to 
event notification facility CENF) to establish listeners for 
DASD volume unload events and SQA shortage events. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 
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IEAVNP17 -~ Generalized Trace Facility RIM 


OPERATION: Initializes GTF's interface with monitor call by 
placing the addresses of the MC routing module, the MC routing 
module's functional recovery routine, the two SETEVENT routines, 
and the cross-address-space-read module into MCHEAD. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


IEAVNP18 = Scheduler Interface to the General Parmlib Scan Routine 


OPERATION: Initializes a parameter list CIEEZB819) and invokes 
the General Parmlib Scan Routine, CIEEMB88&8&), to process the 
SCHEDxx member of SYS1.PARMLIB. 

ENTRY FROM: IEAVNIPM. 


EXIT: Returns to the caller. 


IEAVNP19 -—— Mass Storage System Communicator RIM 


OPERATION: Initializes the software support for mass storage 
system communicator (MSSC) for mounting and demounting mass 
storage volumes on the 3850. (See Mass Storage System 
Communicator Logic: MSS Communicator (MSSC) for details.) 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


IEAVNP20 =~ CLOCK Processing Resource Initialization Module 


OPERATION: Processes the CLOCKxx member of SYS1.PARMLIB. 
ENTRY FROM: IEAVNIPM 
EXIT: Returns to caller. 


ITEAVNP23 ~~ Global Resource Serialization Control Block Initialization 


See the module description for ISGNCBIM. 


ITEAVNP25 -—— SVC Parmlib Processing IRIM 


OPERATION: Processes the IEASVCxx member(s) of SYS1.PARMLIB. 
Nucleus-resident routines are installed immediately. 
Specifications for LPA-resident user-SVCs are saved ina table 
until IEAVNPO05 builds the LPA. 


ENTRY FROM: IEAVNIPM 
EXIT: Returns to the caller. 


IEAVNP27 ~~ Reconfiguration Installed Resources RIM 
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OPERATION: Obtain and initialize the installation channel path 
table CICHPT) and the configuration management table CCMT). 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 
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IEAVNPS3 ~—- Global Resource Serialization Address Space Creation 
See the module description for ISGNTASC. ) 


IEAVNP47 =~ Event Notification Facility RIM 


OPERATION: Initializes the control blocks required for using 
the event notification facility CENF). 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


IEAVNP51 -—— System Trace RIM 


OPERATION: Calls module IEAVTSAS to create the system trace 
address space and initializes the trace function. 


ENTRY FROM: IEAVNIPM. 

EXIT: Returns to the caller. 
ERROR ENTRY: None. 

ERROR EXIT: IGFPTERM. 


IEAVNP57 -——~ Dumping Services Address Space RIM 


OPERATION: Calls module IEAVTSAS to create the dumping services 
address space (DUMPSRV). 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 





IEAVNP76 = LOGREC Initialization RIM 


OPERATION: Locates and opens a cataloged SYS1.LOGREC. If this 
fails, it attempts to open an uncataloged SYS1.LOGREC on SYSRES. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


IEAVN600 =~ CONSOLxXX Member Front End Processor 
OPERATION: Reads the records for the CONSOLxx member of 
SYS1.PARMLIB specified by the CON system parameter. Invokes 
IEEMB887, IEAVN610, and IEAVN613 to validate the CONSOLE, INIT, 
HARDCOPY and DEFAULT statements in the member to select the 
master console and to initialize the UCM control blocks. 
ENTRY FROM: IEAVNPAI 


EXIT.: Returns to the caller. 


IEAVN601 =" CONSOLxx Member Exit -= Part 1 
OPERATION: Sets up an internal work area to record the valid 
values for various Keywords on the CONSOLE, HARDCOPY, and 
DEFAULT statements in a CONSOLxx member of SYS1.PARMLIB. 
ENTRY FROM: IEEMB887 through the parse definitions in IEAVN603. 


EXIT: Returns to the caller. 
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IEAVN602 -—— CONSOLxxX Member Exit = Part 2 


OPERATION: Sets up an internal work area to record the valid 
values for various keywords on the INIT, HARDCOPY, and DEFAULT 
statements in a CONSOLxx member of SYS1.PARMLIB. 

ENTRY FROM: JIEEMB887 through the parse definitions in IEAVN603. 


EXIT: Returns to the caller. 


IEAVN603 =~ CONSOLxx Member Parse Definitions 


OPERATION: This module in non-executable and contains the parse 
rules for the CONSOLE, INIT, HARDCOPY and DEFAULT statements in 
a CONSOLxx member of SYS1.PARMLIB. 

ENTRY FROM: NZA 


EXIT: N/A 


IEAVN604 — CONSOLxx Member Exits — Part 3 


OPERATION: Sets up an internal work area to record the valid 
values for various keywords on the CONSOLE statements in a 
CONSOLxx member of SYS1.PARMLIB. 

ENTRY FROM: JEEMB88&7 through the parse definitions in IEAVN603. 


EXIT: Returns to the caller. 


IEAVN610 -——- CONSOLxx Statement Validation Module 


IEAVN611 — CONSOLE 


IEAVN612 = CONSOLE 


OPERATION: Processes the data in a CONSOLxx member of 
SYS1.PARMLIB by validating the device types of the MCS consoles, 
by performing semantic checking for the keywords on the INIT, 
HARDCOPY, and DEFAULT statements, and by providing default 
values, when required, for those Keywords. 


ENTRY FROM: JIEAVN600, IEAVN601, IEAVN602, and IEAVN613, 
EXIT: Returns to the caller. 


Statement Semantic Module -Part 1 

OPERATION: Validates and applies defaults, when necessary, for 
some of the keywords on the CONSOLE statements in a CONSOLx~x 
member of SYS1.PARMLIB. IEAVN612 validates the remaining 
keywords. 

ENTRY FROM: IEAVN610. 


EXIT: Returns to the caller. 


Statement Semantic Module —Part 2 

OPERATION: Validates and applies defaults, when necessary, for 
some of the keywords on the CONSOLE statements in a CONSOLx~x 
member of SYS1.PARMLIB. IEAVN611 validates the remaining 
keywords. 

ENTRY FROM: IEAVN61lI1. 


EXIT: Returns to the caller. 
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IEAVN613 =~ CONSOLE Configuration Validation Routine 
OPERATION: Validates the master console specification in a ) 
CONSOLxx member of SYS1.PARMLIB and selects one, if necessary. 
This module also validates the alternate console chain and calls 
IEAVN614 to initialize the UCM control block structure. 
ENTRY FROM: IEAVN600. 


EXIT: Returns to the caller. 


IEAVN614 -—— 
OPERATION: Initializes the Unit Control Module CUCM) base and 
its extensions. Also initializes a Unit Control Module Entry 
CUCME) and its extensions for each valid console definition ina 
CONSOLxx member of SYS1.PARMLIB. 
ENTRY FROM: IEAVN613. 
EXIT: Returns to the caller. 

IEAVN700 -——- Communications Task Address Space Create Routine 


OPERATION: Creates the console communications task address 
space by invoking system address space initialization 
CIEEMB88l). 

ENTRY FROM: IEEVIPL. 

EXIT: Returns to the caller. 

ERROR ENTRY: From RTM. 


ERROR EXIT: To IGFPTERM. 





IEAVN701 — Communications Task Address Space Initialization 


OPERATION: Initializes the console communications task address 


Space by: 

e Setting up the cross memory environment 

e Invoking communications task initialization CIEAVVINT) 
e Activating the action message retention facility 

e Attaching the various tasks for communications task 


processing 
ENTRY FROM: IEEPRWI2. 
EXIT: No normal exit. This 1S a permanent task. 
ERROR ENTRY: From RTM. 


ERROR EXIT: No normal exit. This is a permanent task. 


IEAVN702 — Communications Task Initialization Cleanup 


OPERATION: Handles the initialization process separate from 
IEAVN7O1. 


ENTRY FROM: =IEAVN7Ol. 
EXIT: Dispatcher. 
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IEAVN800 -—— Console Default Table 
OPERATION: This non-executable module contains default SEG, 
RNUM, RITME, and AREA values for each device type supported as an 
MCS console. 
ENTRY FROM: N/A 


EXIT: NZA 


IEAVRTOD —~ Time-of-Day Clock Initialization 
OPERATION: Sets the TOD clock to the correct GMT. 
ENTRY FROM: IEAVNPOO. 
EXIT: Returns to the caller. 


IEAVTABI = Recovery Termination Management ABDUMP RIM 
OPERATION: Initializes the RTM control table with 
installation-defined dump options from SYS1.PARMLIB members 
IEAABDOO, IEADMP00, and IEADMROO (for SYSABEND, SYSMDUMP, and 
SYSUDUMP dumps). 
ENTRY FROM: IEAVNIPM. 


EXIT: Returns to the caller. 


IEAVTMSI =~ Recovery Termination Management Initialization 
OPERATION: Establishes three permanent tasks for RIM: the 
asynchronous recording task, an SVC dump task, and the address 
space termination task. 
ENTRY FROM: IEEMB860. 
EXIT: Returns to the caller. 
ENTRY ERROR: At entry point MSIESTAE from ABEND. 


EXIT ERROR: Returns to IEZMB860. 


IEAVTMTC ~~ Address Space Termination Controller Task Initialization 


OPERATION: Creates an SRB that is scheduled when a system 
routine requests address space termination. 


ENTRY FROM: IEAVTMSI. 


EXIT: No normal exit. This is a permanent task. 


IEAVTRET ~~ Recording Task Initialization 


OPERATION: Creates an SRB that is scheduled when a system 
routine requests asynchronous recording. 


ENTRY FROM: IEAVTMSI. 


EXIT: No normal exit. This is a permanent task. 
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IEAVTSAI —— Dumping Services Address Space Initialization 


IEAVTSAS —— DUMPSRV 


OPERATION: Initializes the dumping services address space 
CDUMPSRV) wath a summary dump extended work area and the SDUMP 
virtual storage buffer for eventual use by SDUMP services. 
ENTRY FROM: IEEPRWI2. 


EXIT: IEEPRWI2 terminates the address space or continues to 
initialize the address space. 


ERROR ENTRY: None. 
ERROR EXIT: Returns to the caller with an error return code. 


Address Space Creation 


OPERATION: Invokes IEEMB881 to initiate the creation of the 
dumping services (CDUMPSRV) address space. 


ENTRY FROM: IEAVNP57, IEAVTSDR. 
EXIT: Returns to the caller. 


IEAVTSDD = SVC Dump Data Set Initialization 


OPERATION: Initializes the dump data sets and tapes that are 
specified on the DUMP system parameter. 


ENTRY FROM: IEAVTSDI. 
EXIT: Returns to the caller. 


IEAVTSDI ——~ Recovery Termination Management SVC Dump RIM 


OPERATION: Initializes system areas for SVC dump. 
ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


IEAVTSDT — SVC Dump Task for Master Scheduler (Initialization Function) 


OPERATION: Performs SVC dump processing in each address space 
for which there is a scheduled SVC dump request. 


ENTRY FROM: IEAVTMSI. 


EXIT: No normal exit. This 1s a permanent task. 


IEAVVINT = Communications Task Initialization 
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OPERATION: Sets up for opening the console devices and performs 
initialization for the communications task. It invokes IEECVGCI 
to initialize display consoles. It obtains storage for COMM 
TASK console queueing service of the IEETRACE parameter list. 
ENTRY FROM: IEAVN7Ol1. 


EXIT: Returns to the caller. 
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IEAVXEPM -—— Program Call/Authorization Nucleus Entry Point Search Routine 


IEAVXMAS -—— 


IEAVXSEM -—— 


IECVIOSI — 


IEECVGCI -— 


ITEECVUCM -—— 


TEEMB803 — 


LY28-1200-4 


Program 


Program 


OPERATION: Locates the entry points for various nucleus - 
resident routines that receive control through the program call 
instruction. 

ENTRY FROM: IEAVXMAS and IEAVXECR. 


EXIT: Returns to the caller. 


Call/Authorization Address Space Initialization 

OPERATION: Initializes the PC/AUTH address space (when 
requested by the PC/AUTH RIM, IEAVNPF5) with the PC/AUTH control 
blocks and tables that are needed for cross memory operations. 
ENTRY FROM: IEEPRWI2. 


EXIT: None. Enters a never-ending wait state. 


Call’Authorization System Entry Table Descriptor Module 
OPERATION: This module contains an entry table deScription 
list. The PC/AUTH address space initialization module, IEAVXMAS, 
uses this list to build the system entry table (CSET). 

ENTRY FROM: Not applicable (non-executable module). 


EXIT: Not applicable (non-executable module). 


I0oS Initialization 


OPERATION: Initializes all dynamic pathing devices and 
establishes the IOS storage manager as an ENF listener. 


ENTRY FROM: IEEMB860. 
EXIT: Returns to the caller. 


DIDOCS Initialization 


OPERATION: Determines which display consoles have output~-only 
and/or color capability, and opens SYS1.DCMLIB. 


ENTRY FROM: IEAVVINT. 
EXIT: Returns to the caller. 


Unit Control Module (UCM) Builder 


OPERATION: This non-executable module contains the UCM 
extension, the MCS prefix, the UCM base, the UCM event 
indication list, and 99 individual device entries CUCMEs). 
ENTRY FROM: NZA 


EXIT: NZA 


System Log Task Initialization 


OPERATION: Sets up the data areasS necessary to write in the 
system log data set. It then posts the communications task and 
waits for a request. 


ENTRY FROM: IEEVWAIT at system initialization time. 


EXIT: No normal exit. When the log is closed, IEEMB803 waits 
for it to be activated again. 
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IEEMB809 -—— Master Trace Table Initialization 


OPERATION: Creates or deactivates a master trace table based on ) 
information passed ina parameter list via the JEETRACE macro. 


ENTRY FROM: JEEVIPL at master scheduler initialization time or 
from IEECB806 via the TRACE command. 


EXIT: Returns to the caller. 


IEEMB820 = SMF Initialization Router 


OPERATION: Starts the SMF address space initialization process 
during master scheduler initialization. JIEEMB820 sets up the 
address space attributes and parameters specifying IFASTART as 
the SMF address space initialization module. It then links to 
JTEEMB881 (system address space create routine). Once the 
address space is created, it links to IEFSMFIE to start interval 
recording for the master scheduler address space. 


ENTRY FROM: IEEMB860 
EXIT: Returns to the caller. 








6-22 MVS/XA System Init Logic LY28-1200-4 (Cc) Copyright IBM Corp. 1982, 1987 


"Restricted Materials of IBM" 
Licensed Materials — Property of IBM 


IEEMB860 —— Master Scheduler Region Initialization 


OPERATION: Attaches the SMF initialization router CIEEMB820) to 
start, the SMF address space. It attaches the missing interrupt 
handler CIOSRMIHT) and the IPL/outage recorder CIOSROUTG), 
invokes IEAVTMSI, and waits for SMF initialization and ASM 
initialization to finish. It links to the IOS module, IECVIOSI, 
to initialize dynamic pathing and establish the IOS storage 
manager as an ENF listener. It calls IEFJSIN2 to initialize 
subsystems. It attaches the system security initialization 
routine CICHSEC00) and detaches it when complete. It links to 
IEFHBGI2, the allocation use count gatherer. 


ENTRY FROM: IEFSD263. 
EXIT: To IEEVWAIT via XCTL. 


ERROR ENTRY: At entry point STAOO from failure detection or 
from ABEND. 


ERROR EXIT: Toa wait state. 


IEEMB881 -—- System Address Space Create Routine 


OPERATION: Creates a system address space by 


e Creating and initializing a JSCB for the master scheduler's 
TCB. 

e Obtaining and initializing a START command CSCB. 

Q Calling IEAVEMRQ to obtain an ASID/ASCB. 

e Setting the address space attributes specified by the 
caller. 

e Using IEEVEMCR to create an address space for the caller. 


ENTRY FROM: IEAVNPF5, ISGNTASC CIEAVNP33), IEFAB41I0, IEAVNP57, 
and any other callers of the system address space create 
routine. 


EXIT: Returns to the caller. 


IEEMB883 ——- System Address Space Initialization WAIT/POST Routine 
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OPERATION: Waits on events supplied as input in the form of 
event codes. Only one event, event code 1, is defined. This 
event code causes IEEMB88&3 to wait for the completion of master 
scheduler initialization. IEEMB88&3 is notified of the 
completion of master scheduler initialization by IEEVWNAIT. 


ENTRY FROM: IEEPRWI2 and any routine initializing a system 
address space, such as ITEAVXMAS, ISGNASIM, IEFHB4I1, and 
IEAVTSAI. 


EXIT: Returns to the caller. 
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Parmlib Scan Routine 


OPERATION: Scans the specified SYS1.PARMLIB member, deletes 
comments and collects a record containing the operands for a 
particular statement type. It then passes control to the 

appropriate statement processor routine to handle the record. 


ENTRY FROM: IEAVNP18, IEAVNP20, and IEAVNP25. 
EXIT: Returns to the caller. 


Task Control Processing 


OPERATION: Gets a new region for started task control 
processing. If IEEPRWI2 is executing for a system address 
space, it links to the address space function initialization 
routine if one was specified and calls IEEMB&88&3 to wait for the 
completion of master scheduler initialization. Then IEEPRWI2 
determines whether a START, MOUNT, or LOGON command is being 
processed, and, based on that decision, invokes the appropriate 
command processor. 


ENTRY FROM: Region control task via ATTACH. 
EXIT: To the region control task. 


IEEVCPR —— CONFIG CPU Reconfiguration Processor 


OPERATION: Brings the non-IPL processor online. 
ENTRY FROM: IEAVNPOO. 
EXIT: Returns to the caller. 


IEEVIPL —— Master Scheduler Base Initialization 


IEEVWAIT ~~ Command 
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OPERATION: Initializes the master scheduler, invokes the 
subsystem interface initialization function CIEFJSINT), and 
other initialization routines, specifically IEAVN701, IEFSDO60, 
IEFABGIO, IKJEFXSR, and IEFQBINT. 


ENTRY FROM: IEAVNIPX. 
EXIT: IEFSDO6O. 


ERROR ENTRY: At entry point IPSTAR from failure detection or 
from ABEND. 


ERROR EXIT: To a wait state. 


Scheduler Wait 
For The Master Address Space 


OPERATION: Scans the CSCB chain and, for each pending CSCB that 
represents a command the executes in the master address space, 
attaches the corresponding command processor. Normally, the 
first CSCB processed represents the START command for the 
primary job entry subsystem. After the subsystem is started, 
IEEVWAIT terminates system trace (if specified) and attaches 
IEEMB803, the system log. When IEEVWAIT processes a START 
command CSCB, it checks to see if a system address space 1s 
being started. If so, it bypasses normal START processing and 
just posts the EAEASWT/CHASWT ECB. 


ENTRY FROM: IEEMB860. 
EXIT: No normal exit. This 18 a permanent task. 


ERROR ENTRY: At STAEOO00 from failure detection or from ABEND. 
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ERROR EXIT: To IEEVWAIT'sS main processing for restart or to a 
wait state. 


For The Communications Task Address Space 


OPERATION: Scans the CSCB chain and processes pending commands 
that execute in the communications task address space. 


ENTRY FROM: IEAVN7Ol. 
EXIT: No normal exit. This 1S a permanent task. 


ERROR ENTRY: At entry point STAEO000 from failure or from 
ABEND. 


ERROR EXIT: To dispatcher. 


IEFABGE6 -—— Allocation ESTAE/FRR Recovery Routine 


OPERATION: Handles abnormal terminations of tasks that create, 
initialize, or update the allocation address space CALLOCAS). 


ENTRY FROM: Recovery termination manager CRIM). 
EXIT: Returns to the caller. 


IEFABG4IO — Allocation Initialization Routine 
OPERATION: Invokes the system address space create routine, 
IEEMB881 to create the allocation address space CALLOCAS). 
CIEFHB4I1 initializes the new address space.) It establishes 
the entry points of various allocation functions by storing 
their entry points into the JESCT, the JESCT extension, or the 
CVT. IEFABGI0O0 builds the UCB pointer list (UPL). Stores the 
address of the eligible device list CEDT) into the JESCT and 
invokes the EDT verification routine IEFEB400. 
ENTRY FROM: IEEVIPL 
EXIT: Returns to the caller. 


Called Routine: IEEMB&88&1,ITEFEB400, IGFPTERM 


IEFEB400 —— EDT Verification Routine 
OPERATION: Verifies that the devices defined in the eligible 
device table CEDT) match the devices currently existing in the 
nucleus. 
ENTRY FROM: IEFABGIO. 


EXIT: Returns to the caller. 
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IEFENFFX ~~ Event Notification Request Router 


OPERATION: Checks the validity of the input event parameter 
list of the caller and routes the request for processing. 


ENTRY FROM: ISGNASIM, IEAVNPIF. 
EXIT: Returns to the caller. 
ERROR ENTRY: None. 


ERROR EXIT: Returns to caller with an error return code. 


IEFENFNM — Event Notification Mainline Processing 


OPERATION: Handles all the processing of the event notification 
facility listen elements such as processing for signalling of 
events, processing for listening of events, processing for 
deleting listeners. 

ENTRY FROM: IEFENFFX, IEFENFHWT. 

EXIT: Returns to the caller. 

ERROR ENTRY: None. 


ERROR EXIT: ABEND with a system completion code of X'055'" and a 
reason code of either 36 or 40. 


IEFENFWT ~=— Event Notification Facility Wait Routine 


OPERATION: Processes all pending requests in the event 
notification facility process table. 


ENTRY FROM: Attached as a task by master scheduler 
initialization CIEEMB8&60). 


EXIT: Remains as a never-ending task. 

ERROR ENTRY: At entry point ESTAEXIT Cas an ESTAE) to store 
data in the SDWA, record a SYS]1.LOGREC entry if an SDWA was 
supplied, take a dump, and request retry. 


ERROR EXIT: None. 


IEFHB4I1 — Allocation Address Space Initialization 
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OPERATION: Obtains and initializes all the necessary control 
blocks in the allocation address space and sets up a cross 
memory environment. 

ENTRY FROM: IEEPRWI2. 

EXIT: None. This module enters a never-ending wait state. 
ERROR ENTRY: None. 

ERROR EXIT: 


e Control goes to IEFABSGE6 CFRR/ESTAE) for abnormal 
termination of this task. 


e Return to caller when the ADBUECB is posted indicating that 
ALLOCAS has failed and an SDUMP is in progress. 
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IEFHB4I2 ~~ Display Allocation Scavenge Routine 


OPERATION: Scans all the UCBs in the system and associates the 
allocation use count in each UCB with an address space or 
address spaces. 

ENTRY FROM: IEEMB860. 

EXIT: Returns to the caller. 

ERROR ENTRY: None. 

ERROR EXIT: 


e Return to caller when unit allocation status recording is 
not active. 

e To IEFABS4E6 CFRR/ESTAE) via RTM for abnormal termination of 
this task. 


IEFHB410 -—~ Display Allocation Tables Manager 


OPERATION: Handles all updates to the display allocation tables 
in the allocation address space (ALLOCAS). IEFHBSI0 executes in 
cross memory mode. It is entered by means of a program call 
CPC) to perform one or more of the following functions. 


e Updates the DALT use count field 


e Returns the DALT use count for a unit 

e Returns the DALT use count for one address space and one 
unit 

e Clears the DALT for an address space 


ENTRY FROM: IEFABSA4, IEFABGE5, IEFABGE6, IEFAB434, IEFAB435, 
IEFHB4I2, IEFAB477, IEFDB440. 


exit Returns to the caller by means of a program transfer 
PT). 


ERROR ENTRY: None. 

ERROR EXIT: 

e Return to caller when unit allocation status recording is 
not active. 


e To IEFABGE6 CFRR/ESTAE) via RIM for abnormal termination of 
this task. 


IEFJESDM ~~ Job Entry Subsystem Control Table 


OPERATION: Contains the csect for the IEFJESCT control block. 
ENTRY FROM: Not applicable (non-executable module). 


EXIT: Not applicable (non~executable module). 


IEFJMSFC -—~- Master Subsystem Vector Table Data 


OPERATION: Contains the subpool number for the master 
subsystem's subsystem vector table (SSVT), the names of the 
master subsystem's function routines, and the function codes 
associated with each function routine. 


ENTRY FROM: Not applicable (Cnon-executable module). 


EXIT: Not applicable (non-executable module). 
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IEFJSBLD = Subsystem Service Routine 


OPERATION: Handles common services used in the creation of 
subsystems. The services include building SSCVITs, the master 
subsystem's SSVT, a hash table of SSCVT addresses (SHAS), and 
the SAST. IEFJSBLD also links to individual subsystem 
initialization routines. 


ENTRY FROM: IEFJSINT, IEFJSIN2. 
EXIT: Returns to the caller. 





ERROR ENTRY: At entry point, ESTAEBLD, from ABEND. 

ERROR EXIT: Percolate the error if the error occurred on the 
first SAST build or a LOAD macro failed; otherwise, return to 
the caller. 


IEFJSIMM — Subsystem Initialization Messages 


OPERATION: Contains the messages used during subsystem 
initialization. 


ENTRY FROM: Not applicable (non-executable module). 


EXIT: Not applicable (non-executable module). 


IEFJSIMW —— Subsystem Initialization Message Writer 


OPERATION: Issues messages contained in IEFJSIMM for IEECB805, 
IEFJSBLD, and IEFJSIN2. 


ENTRY FROM: IEECB805, IEFJSBLD, and IEFJSINZ2. 
EXIT: Returns to the caller. 





IEFJSINT —— Subsystem Interface Initialization 
OPERATION: Initializes the JESCT and calls the subsystem 
service routine CIEFJSBLD) to build an SSCVT for the master 
subsystem. 
ENTRY FROM: IEEVIPL. 


EXIT: Returns to the caller. 


IEFJSIN2 ~~ Subsystem Initialization 


OPERATION: For each record in the specified IEFSSNxx members, 
IEFJSIN2 calls: 


1. The parmlib read routine CIEEMB878) to read the record 

2. The positional parser routine CIEEMB882) to parse the record 

3. IEFJSBLD to build a SSCVT and link to the subsystem's 
initialization routine (Cif one is specified). 

IEFJSIN2 also requests that IEFJSBLD rebuild the SAST if 

additional subsystems were defined in SYS1.PARMLIB and build the 

hash table CSHAS). 

ENTRY FROM: IEEMB860. 

EXIT: Returns to the caller. 

ERROR ENTRY: At entry point ESTASIN2 from ABEND. 


ERROR EXIT: Percolate the error if a retry was previously 
attempted; otherwise, return to IEEMB860. 
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IEFPPT -—~ Program Properties Table (PPT) Statement Processor 
OPERATION: Processes the PPT statement in SYS1.PARMLIB member, 
SCHEDxx, and builds a Program Properties Table (PPT) using the 
default PPT and the PPT statements. 
ENTRY FROM: IEEMB8&8&8& 


EXIT: Returns to caller. 


IEFRCSTP ~~ Restart Codes Statement Processor 


OPERATION: Processes the RESTART/NORESTART statements in the 
SYS1.PARMLIB member, SCHEDx~x. 


ENTRY FROM: IEEMB88&8& 
EXIT: Returns to caller. 


IEFSJINT ~~ Scheduler JCL Facility JDVT Initialization 


OPERATION: Creates the default JCL definition vector table 
CJDVT). 


ENTRY FROM: IEEMB860 (via the scheduler JCL facility control 
routine CIEFSJCNL) 


EXIT: IEEMB8&60. 
ERROR ENTRY: At entry point INENTRY from ABEND. 
ERROR EXIT: Return to IEEMB860. 


IEFQBINT ~~ SWA Manager Initialization Routine 
OPERATION: Initializes fields in the JESCT with the addresses 
of the SWA manager, Journal Write and SWA manager diagnostic 
information routines. It also initializes the JESCT with the 
address of the SWA manager storage table CQMST). 
ENTRY FROM: IEEVIPL 


EXIT: Returns to IEEVIPL via a branch. 


IEFQB550 ~~ SWA Manager Move Mode Interface Routine 


OPERATION: Intercepts branches to the SWA Manager Move Mode 
Routine and routes the requests to IEFQB55l1 in the EPLPA. 


ENTRY FROM: Initiator/terminator, scheduler restart, 
convertor/interpreter, JES3. 


EXIT: Returns to IEFQB551 via BSM. 


IFASMF ~~ SMF Control Task 
OPERATION: Completes the initialization of the SMF address 
space (data set initialization). IFASMF controls the execution 
of the SMF commands and IEEMB829 events. 
ENTRY FROM: Attached by initiator to complete initialization. 
Posted by command processors or utility modules to process 
IEEMB829 events. 


EXIT: Returns to the caller. 
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IFASTART ~~ SMF Address Space Initialization Routine 


OPERATION: IFASTART initializes the SMF control blocks (SMCA, 
ACT and SLCA). It then routes control to the proper routine to 
handle SMF parameter processing and the writing of the SMF 
initialization records that describe the current IPL. 


ENTRY FROM: IEEPRW12 
EXIT: Returns to the caller. 


IGFPBUCR =~ Processor MCH Initialization 


IGVNIPCR =~ VSM NIP 


OPERATION: Allocates and initializes the processor work area 
CPWA) and the LOGREC buffer CLRB) for each online processor. 


ENTRY FROM: IGFPINIT 
EXIT: Returns to the caller. 


Contiguous Virtual Storage Routine 

OPERATION: Obtains CSA virtual storage and calls real storage 
management CRSM) to obtain contiguous real frames for SRM 
channel measurement. 

ENTRY FROM: IEAVNPIF. 


EXIT: Returns to the caller. 


IKJEFXSR = Initialization for Linkage to TSO I/0 Service Routines 


OPERATION: Searches the link pack area for certain TSO I/0 
service routines and puts their addresses in the CVT. (The 
names of the service routines are coded into this module.) The 
service routines can now be invoked by TSO command processors 
via the CALLTSSR macro instruction. If TSO/E Release 2 or later 
is installed, IKJEFXSR builds the TSO vector table (TSVT). If 
TSO/E Release 3 or later is installed, IKJEFXSR sets the upper 
limit of broadcast records allowed for the TSO SEND command 
processor. 


ENTRY FROM: IEEVIPL. 
EXIT: Returns to the caller. 


ILRASRIM =~ Auxiliary Storage Management RIM 


OPERATION: Initializes ASM for cold, warm, and quick starts by 
initializing ASM control blocks. Opens PLPA, common, and duplex 
Cif requested) page data sets. Restores PLPA and EPLPA slot 
information of a previous IPL for quick and warm starts. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


ILRASRM1 -— Auxiliary Storage Management RIM -—— Part 2 
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OPERATION: Completes the initialization of ASM control blocks. 
Opens local page data sets and swap data sets. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 
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ILRASRM2 -—— Auxiliary Storage Management Initialization Service Routines 


OPERATION: Contains service routines to: 


e Parse the page, swap, and NONVIO data set name strings. 

e Call ILROPSOO te cpen page data sets and swap data sets. 

e Complete the TPARTBLE and PAT information for page data 
sets. 

e Write the TPARTBLE to the PLPA page data set. 


ENTRY FROM: ILRASRIM, ILRASRM1. 
EXIT: Returns to the caller. 


ILRIMMSG —— Auxiliary Storage Management RIM Message Module 


OPERATION: Contains and writes all ASM initialization messages 
to the operator. 


ENTRY FROM: ILRASRIM, ILRQSRIT. 
EXIT: Returns to the caller. 


ILRMSGOO -—— Auxiliary Storage Management Message Module 


OPERATION: Writes messages to the operator concerning the 
status of PLPA, common, duplex, local, and swap data sets. 
Terminates the system when auxiliary storage management 1s 
unable to continue processing for one of the following reasons. 


0 The PLPA or common data set has become unusable and there is 
no duplex data set available. 


@ The duplex data set has become unusable and the PLPA/common 
data set 1S unavailable. 


e Both the duplex data set and the PLPA/common data set are 
full. 


e The last local page data set has become unusable or full. 
ENTRY FROM: ILRITMIOO. 

EXIT: Returns to the caller. 

ERROR ENTRY: None. 


ERROR EXIT: Put the system into either a X'O02E", X'03C", or 
X'O3E* wait state. 


ILROPSOO -— Auxiliary Storage Management Open Processing 


OPERATION: Opens page and swap data sets; creates and 
initializes I/0 control blocks; calls ILRPREAD to initialize and 
obtain addressability to cached auxiliary storage subsystems. 
ENTRY FROM: ILRASRM2, ILRPGEXP. 

EXIT: Returns to the caller. 


Note: ILRASRIM, ILRASRM1, and ILRPGEXP load ILROPSOO, use it, 
and then delete it. ILROPSOO resides in SYSI].LINKLIB. 
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ILRPREAD ~~ Auxiliary Storage Management Special Read/Write Routine 
OPERATION: Reads from, and writes to, page data sets; 
initializes and obtains addressability to cached auxiliary 
storage subsystems; selects slots for XQSRDs during cold starts 
(quick start record processing). 


ENTRY FROM: ILRASRIM, ILRASRM1, ILRASRM2, ILROPSOO, ILRQSRIT, 
ILRTMIOO. 


EXIT: Returns to the caller. 
Note: Loaded by callers from SYS1.LINKLIB. 





ILRQSRIT = Auxiliary Storage Management Quick Start Record Initialization 
OPERATION: For a cold start only, fills in the quick start 
record (QSRCD), the extended quick start record CEQSRD) and 
quick start record extensions (XQSRDs) writes the TPARTBLE, 
QSRCD, EQSRD and XQSRDs to the PLPA data set. 

ENTRY FROM: IEAVNPOS. 


EXIT: Returns to the caller. 


ILRTMIOO — Auxiliary Storage Management Task Mode Initialization 


OPERATION: Completes the initialization of ASM in the system by 
processing SYSI1.STGINDEX. Specifically, restores virtual [7/0 
(VIO) data set page usage information from the previous IPL, 
builds a list of page and swap data set names, and enqueues on 


SYS1.STGINDEX. 
ENTRY FROM: ILRTMRLG. 
EXIT: Returns to the caller. 


ERROR ENTRY: From ILRIMIOl1 ESTAE routine at one of three 
possible entry points: 





0 ILRCRIM2 - when warm start processing fails. 
0 ILRCRTM3 - when CVIO processing fails. 
0 ILRCRIMG4 - when data set name list processing fails. 


ERROR EXIT: Returns to the caller. 


ILRTMIO1 — ESTAE Routine for ILRTMRLG and ILRTMIOO 
OPERATION: Provides recovery for ILRIMRLG and its calls to 
ILRTMIOO so that ILRTMIOO finishes its initialization and 
ILRTMRLG doesn't terminate. 
ENTRY FROM: RIM. 
EXIT: Returns to the caller or retries into ILRTMRLG or 
ILRTMIOO. 

ILRTMRLG — Auxiliary Storage Management Release Logical Group Module 
OPERATION: Loads and deletes ILRIMIOO, puts the addresses of 
group operator modules into the ASMVT control block, and waits 
to do "release logical group™ requests coming to ASM for saved 
logical groups. 
ENTRY FROM: IEEMB860. 


EXIT: Remains for entire IPL. 
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IOSRMIHT -—— 


IOSVNPTH -— 


IRARMANL -— 


IRARMCPU -— 


Missing 


IOS NIP 


Interrupt Handler Initialization 

OPERATION: Initializes missing interrupt handler (MIH). 
ENTRY FROM: IEEMB860. 

EXIT: Returns to the caller. 


Path Verification Routine 

OPERATION: Validates paths for a device. 

ENTRY FROM: IEAVNPAZ, IEAVNPB2, IEAVNPC2, and IEAVNIPM. 
EXIT: Returns to the caller. 


SRM Parameter Syntax Analyzer RIM 


OPERATION: Checks the syntax of parameters in the IEAIPSx~x, 
IEAICSxx, and IEAOPTxx members of SYS1.PARMLIB. 


ENTRY FROM: IRARMIPS, IRARMICS, IRARMOPT, and IRARMANL 
Crecursive). 


EXIT: Returns to the caller. 


SRM Processor Adjustment Table 


OPERATION: Used by IEAVNP10 to adjust processor model dependent 
fields. 


ENTRY FROM: Not applicable (nor-executable module). 


EXIT: Not applicable (non-executable module). 


IRARMICS -——~ SRM Installation Control Specification Processor RIM 


IRARMIPM =— 


IRARMIPS -—— 


LY28-1200-4% 


OPERATION: Scans the installation control specification list in 
the IEAICSxx member of SYS1.PARMLIB and builds a control block 
for installation control specification information. 

ENTRY FROM: IEAVNPLO. 


EXIT: Returns to the caller. 


IPS, Installation Control Specification, and OPT Error Message Module 


SRM IPS 


OPERATION: Contains the text of messages denoting syntax errors 
detected by IRARMIPS, IRARMICS, and IRARMOPT. 


ENTRY FROM: Not applicable (non-~executable module). 


EXIT: Not applicable (non-executable module). 


Processor RIM 

OPERATION: Scans the installation performance specification 
CIPS) list in the IEAIPSxx member of SYS]1.PARMLIB and builds 
control blocks for IPS information. 

ENTRY FROM: IEAVNPL1O. 


EXIT: Returns to the caller. 
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IRARMOPT =~ SRM OPT Processor RIM 
OPERATION: Scans the OPT list in the IEAOPTxx member of ) 
SYS1.PARMLIB and builds the parameter list containing the SRM 
tuning parameters. 


ENTRY FROM: IEAVNPI1O. 
EXIT: Returns to the caller. 


ISGBCI =~ Global Resource Serialization Ring Processing Command Interface 


OPERATION: Extracts the status of the global resource 
serialization systems and the CTC connections between systems, 
communicates data and commands between systems, and changes the 
configuration of the main ring. 


ENTRY FROM: ISGBTC, ISGCMDR, ISGCOMRG, ISGCPRG, ISGCRST, 
ISGNGRSP, ISGCOSC. 


EXIT: Returns to the caller. 

ERROR ENTRY: None. 

ERROR EXIT: ABEND with completion code of X'09A' and reason 
code that identifies the specific nature of the error. 

ISGBTC -—— Global Resource Serialization CTC Ring Processing Task - Mode Controller 
OPERATION: Performs task-mode services for global resource 
serialization ring processing such as initialization, responding 
to unusual events and exceptions, initiating ring processing 
operations, and cleaning up ring resources. 


ENTRY FROM: ISGNASIM via ATTACH. 


EXIT: None. Posts ISGNASIM, then becomes a never-ending task 
that waits for unusual events or exceptions to occur. 





ISGCMDR = Global Resource Serialization Command Router 


OPERATION: Processes the following global resource 
serialization requests by attaching the appropriate request 
processor. 


Restart request 
Quiesce request 
Purge request 

Display request 
Message request 


ENTRY FROM: ISGNASIM via ATTACH. 


EXIT: Enters a wait state, waiting to process command requests. 
ERROR ENTRY 


e ISGCDRRV - error recovery routine to recover from errors in 
ISGCMDR. 

e ISGCRRO1 ~ error retry entry point in ISGCMDR. 

e ISGCRRO2 - error retry entry point in ISGCTXR1. 

e ISGCTXR1 ~- part of ISGCMDR to detach the command processor 
task and release unneeded storage. 


ERROR EXIT: ABEND with completion code of X'09A' and reason 
code that indicates that the command processor resources to be 
cleaned up were not on the command clean-up queue. 
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ISGCQMRG ~~ Global Resource Serialization Queue Merge 


OPERATION: Ensures that the global resource queue for a system 
joining a global resource serialization complex is identical to 
those of the other active systems already in the complex. 


ENTRY FROM: ISGNGRSP, ISGCRST. 
EXIT: Returns to the caller. 


ERROR ENTRY: ISGCQMRR is the entry point in ISGCQMRG that 
cleans up resources following an error. 


ERROR EXIT: ABEND with completion code of X'OQ9A‘* and reason 
code that indicates the specific nature of the error. 


ISGCRCV ~—— Global Resource Serialization Command Recovery Module 


OPERATION: Provides error recovery and minimal cleanup for 
those modules of global resource serialization that establish it 
(that is, ISGCRCV) as their ESTAE. 

ENTRY FROM: RTM. 

EXIT: Returns to RIM. 


ERROR ENTRY: ISGCRCVY is the entry point in ISGCRCV that 
recovers from errors that occur in ISGCRCV. 


ERROR EXIT: None. 


ISGCRST ~~ Global Resource Serialization Restart Request Processor 


OPERATION: Controls the processing necessary to bring a new 
system into the global resource serialization complex and 
ensures that the new system 1S compatible with the existing 
complex. 


ENTRY FROM: ISGCMDR as an attached task. 
EXIT: Returns to the dispatcher at the normal end of task. 


ERROR ENTRY: ISGCRSO2 is an entry point in ISGCRST that issues 
message ISGO15I and performs back-out processing. 


ISGGQSRV -~— Global Queue Services 


OPERATION: This module is called in three situations: 


0 When global QCBsS need to be processed by ISGCQMRG, this 
module sets the queue merge bit in each QCB to one. 


e When a global QCB has been processed by ISGCQMRG, this 
module sets the queue merge bit to zero. 


0 When global QCBs are to be dequeued by ISGCQMRG, this module 
builds the DEQ QWBs. 


ENTRY FROM: ISGCQMRG. 

EXIT: Returns to the caller. 

ERROR ENTRY: At entry points ISGGRECB and ISGGRTRY by RTM. 
ERROR EXIT: None. 
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ISGGRNLV = Global Resource Serialization RNL Verification Routine 


OPERATION: Checks the validity of the SYSTEM inclusion resource 
name list CRNL), the SYSTEMS exclusion RNL, and the reserve 
conversion RNL Cloaded from SYS1.LINKLIB) to ensure that no 

errors occur during mainline processing of these lists. This 

routine is invoked once per IPL, if the installation opts to 

have RNLs loaded from SYS1.LINKLIB. 


ENTRY FROM: ISGNRNLP. 
EXIT: Returns to the caller. 


ISGGRPOO = Global Resource Serialization Resource Processor 


OPERATION: Processes global resource requests as defined by the 
queue work blocks (QWBs) that exist on the process queue. The 
global resource requests are: 


ENQ/DEQ/RESERVE SVC request 
TCB/DEQ purge request 

ASID DEQ purge request 
SYSID DEQ purge request 
Synchronization request 


ENTRY FROM: ISGNASIM via ATTACH. 
EXIT: Returns to the dispatcher at the normal end of task. 


ERROR ENTRY: At entry point, GRPESTAE, as an ESTAE routine to 
ensure that ISGGRP00 is not terminated before the ISGGRPO00 wait. 


ERROR EXIT: ABEND with completion code of X'09A' and reason 
code that identifies the specific nature of the error. 





ISGGSRVI = Global Resource Serialization Mainline Service Routine Initialization 
OPERATION: Initializes the entry points for all the global 
resource serialization service routines used to provide global 
resource serialization services to the system. 

ENTRY FROM: ISGNASIM. 


EXIT: Returns to the caller. 


ISGJPARM ~~ Global Resource Serialization CTC Configuration Parmlib Processor 


OPERATION: Parses the GRSCNF= system parameter as well as the 
entire GRSCNFxx parmlib member. 


ENTRY FROM: ISGNCBIM. 
EXIT: Returns to the caller. 


ISGMSGOO -— Global Resource Serialization Message Processor 
OPERATION: Provides the global resource serialization services 
with the ability to communicate with the operator using both 
informational CNTO/MLWTO) and reply CWTOR) messages. 


ENTRY FROM: ISGCMDR, ISGNASIM, .ISGNGRSP, ISGCMDI, ISGCRST, 
ISGCQSC, ISGCPRG, ISGBTC, ISGGFRRO. 


EXIT: Returns to the caller. 
ERROR ENTRY: None. 


ERROR EXIT: ABEND with completion code of X'09A' and a reason 
code that identifies the specific nature of the error. 
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ISGNASIM =~ Global Resource Serialization Address Space Initialization 


OPERATION: Initializes the internal control blocks in the 
global resource serialization address space so that global 
resource serialization services can be available to the system. 


ENTRY FROM: IEEPRWI2. 
EXIT: Enters a never-ending wait. 


ERROR ENTRY: ISGNASRV is the entry point in ISGNASIM that 
performs primary recovery of errors occurring during ISGNASIM 
processing. ISGNASIM's ESTAE, ISGCRCV, passes control to this 
entry point. 


ERROR EXIT: ABEND with a completion code of X'O09A' and reason 
code identifying the specific nature of the error. 


ISGNCBIM -—— Global Resource Serialization Control Block Initialization 


OPERATION: Obtains storage for and initializes global resource 
serialization control blocks before the creation of the global 
resource serialization address space and processes the GRS, 
GRSCNF and SYSNAME system parameters. 


ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 


ISGNGRSP — Global Resource Serialization Option Processor 


OPERATION: Processes the GRS=JOIN/START system parameter and 
validates whether the specified GRS=option is consistent with 
the existing global resource serialization complex. 


ENTRY FROM: ISGNASIM via ATTACH. 
EXIT: Returns to the caller. 


ERROR ENTRY: At entry point, ISGNERRX, to investigate the 
nature of the error and retry or terminate processing. 


ERROR EXIT: ABEND with completion code of X'09A* and reason 
code that identifies the specific nature of the error. 


ISGNPARS = Global Resource Serialization Parse Setup Routine 


OPERATION: Initializes the parameter list for the generalized 
parser CIEEMB&887) and then invokes JEEMB88&7 to process the 
specified SYS1.PARMLIB member. 

ENTRY FROM: ISGJPARM, ISGNRNLP. 


EXIT: Returns to the caller. 


ISGNPGIM = POST Global Resource Serialization Initialization 


OPERATION: Notifies global resource serialization address space 
initialization, ISGNASIM, that timer and console services are 
available. 

ENTRY FROM: IEFENFNM Cevent notification facility). 

EXIT: Returns to the caller. 


ERROR ENTRY: At entry point, ISGNPRET, to abnormally terminate 
ISGNASIM. 
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ISGNRNLP = Global Resource Serialization Resource Name List Parmlib Processor 


OPERATION: Validates the GRSRNL= system parameter, parses the 
GRSRNL member(s) of SYS1.PARMLIB, and builds the RNLS in SQA. 


ENTRY FROM: ISGNCBIM. 
EXIT: Returns to the caller. 





ISGNTASC -— Global Resource Serialization Address Space Creation 
OPERATION: Starts the creation of the global resource 
serialization address space by invoking system address space 
initialization, IEEMB88l. 
ENTRY FROM: IEAVNIPM. 
EXIT: Returns to the caller. 
ERROR ENTRY: None. 
ERROR EXIT: ABEND wath completion code of X'O9At and reason 
code that identifies the specific nature of the error. 
ISGNWMSI -—- Global Resource Serialization Wait for Master Scheduler Initialization 
OPERATION: Waits for master scheduler initialization to 
complete on behalf of global resource serialization address 
space initialization, ISGNASIM. 
ENTRY FROM: Dispatcher as a task attached by ISGNASIM. 
EXIT: To the dispatcher at normal end of task. 
ERROR ENTRY: None. 


ERROR EXIT: ABEND with completion code of X'09A*' and reason 
code that identifies the specific nature of the error. 





ISGQSCAN =~ Global Resource Serialization Queue Scanning Services 
OPERATION: Searches the global resource internal queues for 
information requested by the caller on the GQSCAN macro 
instruction. Returns the requested information in an area 
specified by the caller. 
ENTRY FROM: ISGCQMRG. 
EXIT: Returns to the caller. 
ERROR ENTRY: None. 
ERROR EXIT: ABEND with a completion code of X'0O9A' and reason 
code that identifies the specific nature of the error. 


ISGSALC -~ Global Resource Serialization Storage Manager 


OPERATION: Allocates storage cells for global resource 
serialization services to use. 


ENTRY FROM: ISGNASIM. 
EXIT: Returns to the caller. 
ERROR ENTRY: None. 


ERROR EXIT: ABEND wath completion code of X'O09A* and reason 
code that identifies the specific nature of the error. 
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PPENDIX IPL MACRO 
C 


The following macro instructions and mapping macros are 
available to the RIMs for IPL control block and parameter list 
mapping and for linkage to the NIP service routines. (For a 
description of the NIP service ruutines, refer to Appendix B: 
NIP Service Routines. For a description of IPL control blocks 


and parameter lists, refer to MVS/XA Debugging Handbook. 
IPLWTO 
The JPLWTO macro instruction generates linkage to the IPL WTO 
service routine JEAIPL35. 
IHAIVT 


The IJHAIVT macro instruction generates a mapping of the IPL 
vector table CIVT). 


LY28-1200-4 (c) Copyright IBM Corp. 1982, 1987 Appendix A. IPL Macros A-] 


"Restricted Materials of IBM" 
Licensed Materials ~ Property of IBM 





J 








A-2 MVS/XA System Init Logic LY28-1200-4 (c) Copyright IBM Corp. 1982, 1987 


Cc 


"Restricted Materials of IBM" 
Licensed Materials — Property of IBM 


PPENDIX B. 


TEAPMNIP 


TEAPPNIP 


ITEAPSPIO 


IHANVT 


ILREQSRD 


ILRQSRCD 


ILRXQSRD 
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I 


ACROS 


The following macro instructions and mapping macros are 
available to the RIMs for NIP control block and parameter list 
mapping and for linkage to the NIP service routines. (For a 
description of the NIP service routines, refer to Appendix B: 
NIP Service Routines. For a description of NIP control blocks 
and parameter lists, refer to Section 4: Data Areas and to the 


publication Data Areas.) 


The IEAPMNIP macro instruction generates linkage to the 
following NIP service routines: NIPMOUNT, NIPGPEN, NIPPRMPT, 
NIPSENSE, NIPSWAIT, NIPTIME, NIPUCBFN, NIPWTO, NIPWTOR, and 
NIPNTGR2. For the following service routines, IEAPMNIP 
generates parameter lists before establishing linkage: 

NIPMOUNT, NIPOPEN, and NIPWTOR. For the NIPWTO service routine, 
IEAPMHNIP creates the message header before establishing linkage. 


The IEAPPNIP macro instruction generates a mapping of the NIP 
parameter area (NIPPAREA) and the NIP parameter address table 
CPARMTAB). 


The IEAPSPIO macro instruction Serves as an interface to the 
routine that finds and reads text records from the SYS1.PARMLIB 
data set. 


The IHANVT macro instruction generates a mapping of the NIP 
vector table CNVT). IHANVT also generates the system wait state 
codes NIP uses. 


The ILREQSRD mapping macro generates a mapping of the 32-byte 
extended quick start record CEQSRD) header and the 4-byte slot 
map entries contained in the EQSRD. 


The ILRQSRCD mapping macro generates a mapping of the 32-byte 
quick start record (QSRCD) header and the 4G-byte slot map 
entries contained in the QSRCD. 


The ILRXQSRD mapping macro generates a mapping of the 32-byte 
quick start record extension (XQSRD) header and the 8&-byte slot 
map entries contained in the XQSRD. 
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PPENDIX C.. IPL SERVICE ROUTINES 





IPL service routines provide IPL modules with functions that are 
frequently required, or they simulate functions that are not yet 
available in the system. 


IPLWTO 
OPERATION: Writes messages to the message queue. 
INPUT: Register 1 points to the parameter list. 
CALLING MACRO 


7IPLWTO MSG(message) TYPECWTO). 
7IPLWTO MSG(message) TYPECWTL). 


CONTAINED IN: IEAIPL35. 
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NIP service routines provide NIP modules with functions that are 
frequently required, or they simulate functions that are not yet 
available in the system. All NIP service routines are contained 
in the IEAVNIPM load module. 


OPERATION: Ensures that required direct access or tape volumes 
are online and available for further NIP processing. 


INPUT: NIPMOUNT parameter list. 
CALLING MACRO: JIEAPMNIP TYPE=MOUNT, PARAM=label of NIPMOUNT 


CONTAINED IN: IJEAVNPM3. 


OPERATION: Performs the OPEN function of creating and 
initializing a DEB to describe a specified data set. 


INPUT: NIPOPEN parameter list. 
CALLING MACRO: JIEAPMNIP TYPE=OPEN, PARAM=label of NIPOPEN 


CONTAINED IN: IEAVNPM3. 


OPERATION: Issues messages queued prior to master console 
initialization, then issues SPECIFY SYSTEM PARAMETERS message. 
CRIM IEAVNPOl] is the only caller of NIPOPIO.) 


INPUT: Register 2 contains the address of the NVT; register 3 
contains the address of the CVT. 


CALLING MACRO: IEAPMNIP TYPE=OPIO. 
CONTAINED IN: IEAVNIPM. 


OPERATION: Passes control to IEAVNPO3, which prompts the 
operator for required parameters that have not been specified or 
that have been invalidly specified. 


INPUT: Label of 8-character field containing the name of the 
parameter for which prompting 1s to take place. 


CALLING MACRO: IEAPMNIP TYPE=PRMPT, PARAM=label of parameter 


CONTAINED IN: IEAVNIPM. 


PPENDIX D. NIP SERVICE ROUTINES 
NIPMOUNT 

parameter list. 
NIPOPEN 

parameter list. 
NIPOPIO 
NIPPRMPT 

field. 
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OPERATION: Interprets sense data after an I/O error occurs and J 
writes a diagnostic message to the master operator console. 


INPUT: Register 1 points to the IOB. 
CALLING MACRO: IEAPMNIP TYPE=SENSE, PARAM=register pointing to 
IOB. 


CONTAINED IN: IEAVNIPM. 


OPERATION: Places system in disabled wait state, abnormally 
terminating system initialization. 


INPUT: Wait state code and optional diagnostic information in 
field NPMPSW2 of the PSW CNPMNTPSW) passed to NIPSWAIT. 


CALLING MACRO: IEAPMNIP TYPE=SWAIT. 
CONTAINED IN: IEAVNIPM. 


OPERATION: Provides the time of day in decimal for 
time-stamping messages, or provides a fullword binary value that 
reflects the number of hundredths of seconds elapsed since 
IEAVNIPM was first entered for the current system initialization 
process. 


INPUT: Register 1 contains either a zero for decimal time 
requests or a four for binary time requests. ) 


CALLING MACRO: IEAPMNIP TYPE=TIME, PARAM=DEC or PARAM=BIN 
CONTAINED IN: IEAVNIPM. 





OPERATION: Locates a UCB using the corresponding EBCDIC unit 
name or hexadecimal device address (CUA). 


INPUT: Register 1 contains either the EBCDIC unit name or the 
hexadecimal unit address. 


CALLING MACRO: IEAPMNIP TYPE=UCBFN, PARAM=register containing 
EBCDIC or hexadecimal unit. 


CONTAINED IN: IEAVNIPM. 


OPERATION: Writes messages to the master operator console. 


INPUT: Register 1 contains a pointer to the NIPNTO message 
header. 


CALLING MACRO: IEAPMNIP TYPE=WTO, PARAM=message header label. 
CONTAINED IN: IEAVNPM2. 
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NIPWTOR 
OPERATION: Writes messages to the master operator console and 

reads the associated replies. 
INPUT: Register 1 contains a pointer to the NIPWTOR parameter 
list. 
CALLING MACRO: IEAPMNIP TYPE=WTOR, PARAM=parameter list label. 
CONTAINED IN: IEAVNPM2. 

NIPHWTOR2 


OPERATICN: (1) Waits for the completion of an operator's reply 
associated with an earlier NIPWTOR message, (2) frees an SQA 
reply buffer, or (3) frees the master-console-image buffer. 


INPUT: Register 1 contains (1) the address of the associated 
NIPWNTOR parameter list, (2) the address in two's complement form 
of the SQA reply buffer, or (3) the value zero. 

CALLING MACRO: (1) IEAPMNIP TYPE=WTOR2, PARAM=parameter 
register; (2) IEAPMNIP TYPE=WTOR2Z, BUFREL=YES, PARAM=parameter 
register; (€3) IEAPMNIP TYPE=WTOR2, BUFREL=YES, PARAM=0. 


CONTAINED IN: IEAVNPM2. 
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ATIONS 


ABDUMP (snap dump) 

ABEND Cabnormal end) 

abnormal end CABEND) 

ACB Caccess method control block) 

access method control block CACB) 

access method work area CAMWA) 

ACE CASM control element) 

ADB Callocation descriptor block) 

address increment map CAIM) 

address increment map entry CAIME) 

address queue anchor table CAQAT) 

address queue anchor table index (CAQATINDX) 
address space control block CASCB) 

address space extension block CASXB) 
address space identifier CASID) 

address space table entry CASTE) 

address space vector table (CASVT) 

ADRTABLE contains the addresses at which the csect of 
the nucleus is loaded) 

AFC Cavailable frame count) 

AFQ Cavailable frame queue) 

AIM Caddress increment map) 

AIME Caddress increment map entry) 
allocation descriptor block CADB) 

AMDSB CVSAM access method data statistics block) 
AMNA Caccess method work area) 

APF Cauthorized program facility) 

APG Cautomatic priority group) 

AQAT Caddress queue anchor table) 

AQATINDX Caddress queue anchor table index) 
ASCB Caddress space control block) 

ASID Caddress space identifier) 

ASM Cauxiliary storage management) 

ASM control element CACE) 

ASM page allocation table (PAT) 

ASMVT Cauxiliary storage management vector table) 
ASTE Caddress space table entry) 

ASVT Caddress space vector table) 

ASXB Caddress space extension block) 
authorization index allocation table (CAXAT) 
authorized program facility CAPF) 

automatic priority group CAPG) 

auxiliary storage management CASM) 
auxiliary storage management vector table CASMVT) 
available frame count CAFC) 

available frame queue (AFQ) 

AXAT Cauthorization index allocation table) 


BASEA (master scheduler resident data area) 
BUFC Cbuffer control block) 
buffer control block CBUFC) 
build directory list (CBLDL) 


CACE (cache array element) 

CACHE (cache array table) 

CCT CCPU control table) 

CCW Cchannel command word) 

CDE (contents directory entry) 

cell pool anchor block (CCPAB) 

central processing unit (CPU) 

CESD (composite external symbol table) 
channel command word (CCW) 

channel measurement block (CCMB) 
channel path measurement table (CCPMT) 
channel report word (CCRW) 

CMB Cchannel measurement block) 
command recovery work area (CRWA) 
command request block (CRB) 
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command scheduling control block CCSCB) . 
common service area (CSA) : 
common system data area (CSD) 

common VTOC access facility CCVAF) 
communications vector table (CVT) 
composite external symbol table (CESD) 
contents directory entry CCDE) 

control section CCSECT) 

CPAB Ccell pool anchor block) 

CPMT Cchannel path measurement table) 
CPU Ccentral processing unit) 

CPU control table (CCT) 

CRB Ccommand request block) 

cross memory directory CXMD) 

CRW Cchannel report word) 

CRWA Ccommand recovery work area) 

CSA Ccommon Service area) 

CSCB Ccommand scheduling control block) 
CSD Ccommon system data area) 

CSECT Ccontrol section) 

CVAF Ccommon VTOC access facility) 

CVT Ccommunications vector table) 


DAE (dump analysis and elimination) 
DAIT Cdisplay allocation index table) 
DALT Cdisplay allocation lookup table) 
DASD (direct access storage device) 
DAT Cdynamic address translation) 
data control block (DCB) 

data definition (CDD) 

data definition name CDD name) 

data event control block CDECB) 

data extent block (CDEB) 

data set association block CDSAB) 
data set control block CDSCB) 

data set work area CDSTBL) 

DBVT Cdevice block vector table) 

DCB Cdata control block) 

DCM Cdisplay control module) 

DCQ (device class queue) 

DCTI Cdevice connect time interval) 
DD €data definition) 

DD name (data definition name) 

DEB (data extent block) 

DECB Cdata event control block) 
descriptor queue element CDQE) 

device block vector table CDBVT) 
device class queue (DCQ) 

device connect time interval CDCTI) 
device measurement block CDMB) 
device-independent display operator console support 
CDIDOCS) 

device table (CDEVTAB) 

DEVTAB Cdevice table) 

DFE Cdouble free element) 

DIDOCS (Cdevice-independent display operator console 
support) 

direct access storage device (DASD) 
display allocation index table (CDAIT) 
display allocation lookup table CDALT) 
display allocation vector table (DVT) 
display control module CDCM) 

DFL CDAE default option) 

DMB (Cdevice measurement block) 

DMDT Cdomain descriptor table) 

domain descriptor table (CDMDT) 

double free element CDFE) 

DQE Cdescriptor queue element) 

DSAB Cdata set association block) 
DSCA CDAE communication area) 

DSCB Cdata set control block) 

DSPD CDAE pre-dump/post dump parameter list) 
DSTBL Cdata set work area) 

DVCT Cdevice characteristic table) 
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DVT (display allocation vector table) 
dynamic address translation (DAT) 


EBCDIC Cextended binary coded decimal interchange code) 
EC Cextended control) 

ECB Cevent control block) 

ECSA Cextended common service area) 

EDT Celigible device table) 

eligible device table CEDT) 

ELPA Cextended link pack area) 

ELSQA Cextended local system queue area) 
EMLPA Cextended modified link pack area) 
ENF Cevent notification facility) 

entry point CEP) 

entry table descriptor CETD) 

entry table information block CETIB)D 
EPFP Cextended precision floating point) 
EPLPA Cextended pageable link pack area) 
EQSRD Cextended quick start record) 

ERP Cerror recovery procedure) 

ERPIB Cerror recovery procedure information block) 
error recovery procedure CERP) 

error recovery procedure information block CERPIB)D 
ESD Cexternal symbol dictionary) 

ESDID Cexternal symbol dictionary ID) 
ESQA Cextended system queue area) 

ESR Cextended SVC router) 

ESW Cextended status word) 

ETD Centry table descriptor) 

ETIB Centry table information block) 
event control block CECB) 

event notification facility CENF) 
extended binary coded decimal interchange code CEBCDIC) 
extended common service area (CECSA) 
extended control (CEC) 

extended link pack area CELPA) 

extended local system queue area CELSQA) 
extended modified link pack area CEMLPA) 
extended pageable link pack area CEPLPA) 
extended precision floating point CEPFP) 
extended quick start record CEQSRD) 
extended status word CESW) 

extended SVC router CESR) 

extended system queue area CESQA) 
external page table CXPT) 

external page table entry (XPTE) 
external symbol dictionary CESD) 
external symbol dictionary ID CESDID) 


FBLDL (fixed build directory list) 
FBQE (free block queue element) 
first level interrupt handler CFLIHD 
fixed build directory list (CFBLDL) 
fixed link pack area (FLPA) 

FLIH (first level interrupt handler) 
FLPA (fixed link pack area) 

FQE (free queue element) 

free block queue element CFBQE) 

free queue element CFQE) 

FRR (functional recovery routine) 
functional recovery routine (CFRR) 


GCC Cglobal resource serialization CTC-driver control card table) 
GDA (Cglobal data area) 

Generalized Trace Facility (GTF) 

GGSA (global group summary area) 

global data area (GDA) 

global group summary area (GGSA) 

global queue hash table (GQHT) 

global queue work area (GQWA) 

global resource pool table (CGRPT) 

global resource serialization vector table (GVT) 

global resource serialization vector table extension (GVTX) 
global system duplex area (GSDA) 
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GMT (Greenwich Mean Time) 

GQHT (Cglobal queue hash table) 

GQWA Cglobal queue work area) 

Greenwich Mean Time (GMT) 

GRPT (global resource pool table) 

GSDA (global system duplex area) 

GIF €Generalized Trace Facility) 

GVT Cglobal resource serialization vector table) 

GVITX Cglobal resource Serialization vector table extension) 


global work/save area vector table CWSAG) 





hardware save area (HSA) 
HOTIO Chot input/output) 
HSA Chardware save area) 


ICHPT Cinstalled channel path table) 

ICT Cinput/output control table) 

ID Cidentifier) 

identifier CID) 

IEL Cinitiator entrance list) 

initial program loader CIPL) 

initiator entrance list CIEL) 

input/output (1/0) 

input/output block CIOB) 

input/output control table CICT) 

input/output management block CIOMB) 
input/output supervisor CIOS) 

inpucsoutput supervisor communication extension table 
installation performance specifications CIPS) 
installed channel path table CICHPT) 
interruption queue element CIQE) 

interruption response block CIRB) 

I/O Cinput/output) 

IOB Cinput/output block) 

Tote (input/output supervisor communication extension 
able 

IOMB Cinput/output management block) 

IdS Cinput/output supervisor) 

IOSB Cinput/output supervisor block) 

IPL Cinitial program loader) 

IPL resource initialization module CIRIM) 

IPL vector table CIVT) 

IPS Cinstallation performance specifications) 
IQE Cinterruption queue element) 

IRB Cinterruption response block) 

IRIM CIPL resource initialization module) 

IVT CIPL vector table) 





JCL Cjob control language) 

JES Cjob entry subsystem) 

JESCT Cjob entry subsystem control table) 
job control language (JCL) 

job entry subsystem (CJES) 

job entry subsystem control table (JESCT) 
job step control block (JSCB) 

JSCB Cjob step control block) 

JSSNT Csubsystems name table) 


K €1024 bytes) 


LCCA Clogical configuration communications area) 
LDA Clocal data area) 

LGN Clogical group number) 

LGRAS Clogical group of unusable slots) 
LGSA Clocal group summary area) 

LGVT Clogical group vector table) 

link pack area (LPA) 

link pack directory entry (LPDE) 
linkage index allocation table CLXAT) 
LLE Cload list element) 

load list element CLLE) 

local data area (LDA) 

local group summary area (LGSA) 
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local queue hash table (LQHT) 
local queue work area (LQWA)D 
local resource pool table (LRPT) 
local system queue area (LSQA) 
logical configuration communications area (LCCA) 
logical group number (CLGN) 
logical group vector table (LGVT) 
logical path control block (CLPB) 
logical slot identifier (LSID) 
LOGREC record block CLRB) 

LPA Clink pack area) 

LPB Clogical path control block) 
LPB table (LPBT)D 

LPBT CLPB table) 

LPDE Clink pack directory entry) 
LQHT Clocal queue hash table) 
LQWA Clocal queue work area) 

LRB CLOGREC record block) 

LRPT Clocal resource pool table) 
LSID C€logical slot identifier) 
LSQA Clocal system queue area) 
LXAT Clinkage index allocation table) 


machine check handler (MCH) 

main storage control table (MCT) 

mass storage system (MSS) 

mass storage system communicator (MSSC) 
master scheduler resident data area (BASEA, MSRDA) 
Mb (megabyte) 

MC Cmonitor call) 

MCH Cmachine check handler) 

MCHEAD Cmonitor call tables head) 

MCRWSA (Cmonitor call routing work/save area) 
MCS Cmultiple console support) 

MCT (main storage control table) 

megabyte (Mb) 

message request block CMRB) 

MIH Cmissing interruption handler) 

missing interruption handler (MIH) 

MLPA (modified link pack area) 

modified link pack area (MLPA) 

monitor call (CMC) 

monitor call routing work/save area (MCRWSA) 
monitor call tables head (MCHEAD) 

monitoring and service support facility (MSSF) 
MP (multiprocessing) 

MPL Cmultiprogramming level) 

MQE (message queue element) 

MQH (message queue header) 

MRB (message request block) 

MSRDA (master scheduler resident data area) 
MSS (mass storage system) 

MSSC (mass storage system communicator) 

MSSF Cmonitoring and service support facility) 
multiple console support (MCS) 
multiprocessing (CMP) 

multiprogramming level (MPL) 


NCT CNIP console table) 

NIP Cnucleus initialization program) 
NIP parameter address table CPARMTAB) 
NIP parameter area (NIPPAREA) 

NIP vector table C(NVT) 

NIPPAREA CNIP parameter area) 

NLL nucleus load list 

NLLE nucleus load list element 
nucleus initialization program (NIP) 
nucleus load list CNLL) 

nucleus load list element (NLLE) 

NVT CNIP vector table) 


operation request block (CORB) 
operator reply element CORE) 
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ORB Coperation request block) 
ORE Coperator reply element) 


page control block (PCB) 

page frame table CPFT) 

page frame table entry CPFTE) 

page table (PGT) 

page table entry (PGTE) 

pageable display control module CTDCM) 
Pageable link pack area CPLPA) 

Paging activity reference table CPART) 
paging channel command work area (PCCW) 
PARMTAB CNIP parameter address table) 
PART (Cpaging activity reference table) 
partitioned data set (PDS) 

PAT CASM page allocation table) 

PC (program call) 

PCB (page control block) 

PCCA Cphysical communications configuration area) 
PCCA vector table (CPCCAVT) 

PCCAVT CPCCA vector table) 

PCCW Cpaging channel command work area) 
PCI (Cprogram-controlled interrupt) 

PDS (partitioned data set) 

PEXB Cpool extent block) 

PFK Cprogram function Key) 

PFT Cpage frame table) 

PFTE Cpage frame table entry) 

PGT (Cpage table) 

PGTE Cpage table entry) 

physical communications configuration area (PCCA) 
PLPA Cpageable link pack area) 

pool extent block CPEXB) 

PRB Cprogram request block) 

prefixed SAVE area (PSA) 

processor work area (PWA) 

program call (PC) 

program-controlled interrupt CPCI) 

program function key (CPFK) 

program request block (CPRB) 

program status word CPSW) 

PSA Cprefixed SAVE area) 

PSW Cprogram status word) 

PVT CRSM paging vector table) 

PNA Cprocessor work area) 








QCB Cqueue control block) 
QDB Cqueue descriptor block) 
QEL Cqueue element) 

QSRCD Cquick start record) 
queue control block (CQCB) 
queue descriptor block (CQDB) 
queue element (CQEL) 

queue extension block (CQXB) 
queue work block (CQWB) 

quick start record CQSRCD) 
QNWB Cqueue work block) 

QXB (queue extension block) 


RAB CRSM address space control block) 
RB Crequest block) 

RBA Crelative byte address) 

RBN Creal block number) 

RCB Crecording control block) 

RCBSRB Crecording task SRB) 

RCT Cregion control task, routing control table) 
RD C€region descriptor) 

RDCM Cresident display control module) 
real block number CRBN) 

real storage management (RSM) 
reconfigurable storage unit CRSU) 
recording control block CRCB) 
recording task ECB CRICTECB) 

recording task SRB CRCBSRB) 
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recovery management support (RMS) 

recovery management support secondary communications 

vector table CRVT) 

recovery termination management (CRIM) 

recovery termination management control table CRTICT) 
region control task CRCT) 

region descriptor (CRD) 

relative byte address (RBA) 

relocation dictionary CRLD) 

request block CRB) 

resident display control module (CRDCM) 

resource information block CRIB) 

resource information block extension CRIBE) 
resource initialization module (RIM) 

resource name list CRNL) 

resource queue area (RQA) 

RIB (resource information block) 

RIBE (resource information block extension) 

RIM Cresource initialization module) 

RIT CRSM internal table) 

RLCT Csystem resources manager logical channel table) 
RLD Crelocation dictionary) 

RMCT Csystem resources manager control table) 

REP ssystem resources manager algorithm entry point 
lock 

RMPT Csystem resources manager parameter table) 

RMS Crecovery management support) 

RNL Cresource name list) 

RQA Cresource queue area) 

RSM Creal storage management) 

RSM address space control block CRAB) 

RSM external page table (XPT) 

RSM external page table entry (CXPTE) 

RSM internal table CRIT) 

RSM paging vector table (PVT) 

RSU Creconfigurable storage unit) 

RTCT (€recovery termination control table, recovery 
termination management control table) 

RTCT extension for SVC dump CRTSD) 

RTCTECB Crecording task ECB) 

RTM Crecovery termination management) 

RTSD CRTCT extension for SVC dump) 

RVT Crecovery management support secondary 
communications vector table) 


SAHT CSYSID/ASID hash table) 

SALLOC Cstorage allocation) 

SART (swap activity reference table) 

SAST Csubsystem allocation sequence table) 
SAT Cswap allocation table) 

SCCW (swap channel command work area) 

SCD (status collection data area) 
scheduler NIP parameter list CSNPL) 
scheduler work area A) 

SCHIB Csubchannel information block) 

SCSW Csubchannel status word) 

SCVT Csecondary communications vector table) 
SDDSQ (CSDUMP dump data set queue) 

SDT (start descriptor table) 

SDUMP dump data set queue (SDDSQ) 

SDWA Csystem diagnostic work area) 

second level interrupt handler (SLIH) 
second level table (SLT) 

secondary communications vector table (CSCVT) 
segment table (SGT) 

segment table entry (CSGTE) 

service request block (SRB) 

SET (system entry table) 

set task asynchronous exit (CSTAE) 

SFQ CSQA frame queue) 

SFT Csystem function table) 

SGT Csegment table) 

SGTE (segment table entry) 

SHAS Csubsystem hash table) 
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SIC (system-initiated cancel) | 
SIRB (system interrupt request block) 
Size queue anchor table CSQAT) 

SLH Csubchannel logout handler) 

SLIH C€second level interrupt handler) 

SLR C€subchannel logout record) 

SLT C€second level table) 

SMCA Csystem management control area) 

SMEW Csummary dump extended work area) 

SMF Csystem management facilities) 

SMPL Cstorage manager parameter list) 

snap dump CABDUMP) 

SNPL Cscheduler NIP parameter list) 

SPE C€system parameter element) 

SPQE Csubpool queue element) 

SQA (system queue area) 

SQA frame queue (CSFQ) 

SQAT (Csize queue anchor table) 

SRB (service request block) 

SRM (system resources manager) 

SSCVT (subsystem communications vector table) 
SSIB Csubsystem identification block) 

SSPL Csubsystem service routine parameter list) 
SSVT Csubsystem vector table) 

STAE (set task asynchronous exit) 

start descriptor table (SDT) 

started task control internal reader CSTCINRDR) 
STCINRDR (started task control internal reader) 
storage manager parameter list CSMPL) 
subchannel information block CSCHIB) 

subchannel logout handler (SLH) 

subchannel logout record (SLR) 

subchannel status word (CSCSW) 

subpool queue element CSPQE) 

subsystem allocation sequence table (SAST) 
subsystem communications vector table (SSCVT) 
subsystem hash table CSHAS) 

subsystem identification block CSSIB) 

subsystem service routine parameter list (CSSPL) 
subsystem vector table (SSVT) 

subsystems name table CJSSNT) 

summary dump extended work area CSMEW) 
supervisor call (SVC) 

supervisor request block CSVRB) 

supervisor vector table (SVT) 

SVC CsSupervisor call) 

SVT Csupervisor vector table) 

SVRB (supervisor request block) 

SWA Cscheduler work area) 

swap activity reference table CSART) 

swap allocation table (SAT) 

swap channel command work area (SCCW) 

SYSGEN (system generation) 

SYSID/ASID hash table CSAHT) 

SYSRES (system resident device) 

system diagnostic work area (CSDWA) 

system entry table CSET) 

system Tunction table (SFT) 

system generation CSYSGEN) 

system-initiated cancel (SIC) 

system management control area (CSMCA) 

system management facilities (SMF) 

system parameter element (SPE) 

system queue area (SQA) 

system resident device (CSYSRES) 

system resources manager (SRM) 

eye ten resources manager algorithm entry point block 
system resources manager control table CRMCT) 
system resources manager logical channel table (RLCT) 
system resources manager user control block CUDCB) 
system resources manager user extension block CUQXB) 
system trace buffer CTBUF) 

system trace buffer vector table (TBVT) 
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task control block CTCB) 

task input-output table (TIOT) 

TBUF (system trace buffer) 

TBVT Csystem trace buffer vector table) 

TCB Ctask control block) 

TCWA CTOD clock work area) 

TDCM Cpageable display control module) 
temporary page activity reference table CTPARTBLE) 
time-of-day (CTOD) 

time sharing option (TSO) 

time sharing option internal reader CTSOINRDR) 
timer queue element CTQE) 

timer work area (TPC) 

TIOT (Ctask input-output table) 

TLB Ctranslation lookaside buffer) 

TOD (Ctime-of-day) 

TOD clock work area CTCWA) 

TPARTBLE Ctemporary page activity reference table) 
TPC Ctimer work area) 

TQE Ctimer queue element) 

translation lookaside buffer CTLB) 

TSO Ctime sharing option) 

TSOINRDR Ctime sharing option internal reader) 


UADS Cuser attribute data set) 

UCB Cunit control block) 

UCB pointer list CUPL) 

UCM Cunit control module) 

UCME Cunit control module entry) 

unit control block CUCB) 

unit control module CUCM) 

unit control module entry CUCME) 

UOCB (system resources manager user control block) 
UOXB (system resources manager user extension block) 
UPL CUCB pointer list) 

user attribute data set CUADS) 


VER Cvirtual equals real) 

VBP (virtual block processor) 

VIO Cvirtual input/output) 

virtual block processor CVBP) 
virtual equals real CV=R) 

virtual input/outsut CVIO) 

virtual storage access method CVSAM) 
virtual storage management CVSM) 
volume table of contents CVTOC) 

VSAM C(Cvirtual storage access method) 
VSAM access method data statistics block CAMDSB) 
VSM work area CVSWK) 

VSWK CVSM work area) 

VTOC Cvolume table of contents) 


WMST Cworkload manager specification table) 
workload manager specification table CWMST) 
WQE Cwrite queue element) 

write queue element CWQE) 

write-to-operator CWTO) 

write-to-operator with reply CWTOR) 

WSAG Cglobal work/save vector table) 

WTO Cwrite-to-operator) 

WTOR Cwrite-to-operator with reply) 


XMD Ccross memory directory) 
XPT CRSM external page table) 
XPTE CRSM external page table entry) 
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abbreviation list E-l 

ABDUMP 
initialization 5-294 

ABDUMP dumping service 


initialization 5-100 
ABEND codes 

customizing 5-482 

IEFRCSTP 5-482 


NORESTART 5-482 
RESTART 5-482 
ABEND macro instruction 
description of NIPABEND trap 3-4, 
-5 
releasing of traps 3-5, 5-534 
setting of traps 3-5, 5-69, 5-86 
SVC table entry initialization 5-534 
ACB initialization 5-638 
ACR routine 5-135 
action message retention 
facility 5-578, 5-585 
ACTIVE 
description of SMF Keyword 5-631 
ADB 5-628 


address increment initialization 5-6l, 
5-176, 5-272 
address space 
definition 1-13 
full function 5-547 
limited function 5-547 
system 5-535 
create routine 5-535 
IEEMB88&1 5-535 
termination 
controller attached 5-635 
request for 5-635 
address wraparound area 
initialization 5-46 
AFQ initialization 5-269 
AFT initialization 5-100, 5-267 
AHLMCER 
function 5-430 
AHLSETD 
function 5-430 
AHLSETEV 
function 5-430 
AIM 
definition 5-61 
non-preferred storage 
initialization 5-272 
preferred storage 
initialization 5-61 
V=R region initialization 5-176 


ALLOCAS 5-626 
ALLOCAS address space 
initialization 1-10, 1-12, 5-623 
module flow 4-12 
module flow overview 4-24 
allocation 


abends 5-626 
address space initialization 5-626, 
5-628 


address space initialization 
overview 4-24 
IEFABGIO 5-623 
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initialization 5-623, 5-649 
allocation address space 
See ALLOCAS address space 
allocation control blocks 
initialization 5-581 
DSAB 5-581 
QDB 5-581 
TIOT 5-581 
Allocation Load EDT 
IEFABGIE 5-475 


alternate console initialization 5-162 
alternate nucleus 
specifying 1-24 
ALTRTRC service 
use in system trace 
initialization 5-319 
AMB initialization 5-92 
AMCBS initialization 5-93, 5-197 
AMODE bit for SVCs 
initialization 5-12 
APF system parameter 
cross-reference table 1-23 
definition 1-20 
APF table 
initialization 5-97, 5-174 
APF table, building 5-92 
APG system parameter 
cross-reference table 1-23 
definition 1-20 
processing 5-278 
appendage name table 
initialization 5-104, 5-423 
AQAT initialization 
for CSA 5-259 
for ECSA 5-259 
for ESQA 5-4G, 5-214 
for SQA 5-4qG, 5-211 
AQAT stack initialization 5-48 
AQATINDX initialization 
for ELSQA 5-48 
for ESQA 5-GG, 5-214 
for SQA 5-211 
ASCB initialization 
for system address spaces 5-539 
ASID initialization 
for system address spaces 5-539 
ASM 
cell pool creation 5-220 
control block initialization 5-195 


data set name list initialized 5-639 
description of RIM for 1-7 

EQSRD initialization 5-174, 5-255 
initialization 5-96 

message module 5-198, 5-639 

open processing 5-200 

Paging data sets 5-640 

QSRCD initialization 5-174, 5-255 
pecovery process 5-640 


ILRASRIM 5-96, 5-194 
ILRASRM1 5-96 
SART initialization 5-640 


slot read/write routine 5-204 
swap data sets 5-640 
task mode initialization 5-638 


VIO data set initialization 5-638 
ASMVT initialization 5-638 
AST initialization 5-267 
1987 Index I-11 


5-100, 5-314 
5-75, 5-100, 5-267, 


ASTE initialization 
ASVT initialization 
5-314 
attribute list CEATTR) initialization 
check for validity 5-537 
for CONSOLE 5-574 
for DUMPSRV 5-357 
for GRS 5-320 
for PC/AUTH 5-309 
for system address spaces 
automatic commands 
Processing 5-426 
automatic restart codes 5-G8&2 
auxiliary storage management 
cached auxiliary storage 
subsystem 5-638 
CVIO 5-638 
ILRTMIOO 5-638 
initialization 5-638 
initialization part 2 


5-539 


function 5-216 
SYS1.STGINDEX 5-638 
VIO 5-638 


available frame queue 
building 5-62 

AXAT initialization 

AXSET macro 5-628 


BASEA initialization 5-536, 5-541 
broadcast record limit for TSO SEND 
command 5-560 
Build DAT-on nucleus 
IEAIPLG1 5-30 
building page tables 5-22 
building segments 5-22 
building the PSW 5-22 
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cached auxiliary storage 
subsystem 5-638 


5-313 


CAST initialization 5-428 
CCHHR address 5-22 
CCT initialization 5-277, 5-278, 5-280 


CCW 
for ASM read/write routine 
channel measurement 
initialization 5-288 
channel path 
ICHPT initialization 
UCB initialization 
channel program 
starting 5-13, 5-16 
ISVCXDAP 5-16 
character readers 5-289 
CIB initialization 5-553 
CLOCK 
Greenwich Mean Time 5-501 
IEAVNP2O0 5-501 
Parmlib member 5-501 
setting the time of day 5-501 
CLOCK system parameter 
definition 1-20 
CLOCKxx member of SYS1.PARMLIB 
description 1-20 
CLPA system parameter 


5-205 


5-159 
5-159 
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affect on ASM initialization 1-19, 
-—9G 
cross-reference table 1-23 
definition 1-20 
CMB 
definition 5-289 
initialization 5-289 
CMB system parameter 
cross-reference table 1-23 
definition 1-20, 5-289 
Processing 5-289 
CMD system parameter 
cross-reference table 1-23 
definition 1-20 
Processing 5-G26 
cold start 
definition 1-18 
PLPA initialization 5-247 
processing 5-195, 5-211 
use of QSRCD and EQSRD 5-255 
command router 
activated 5-330 
commands 
automatic 5-426 
COMMNDxx 5-425 
COMMNDxx member of SYS1.PARMLIB 
automatic commands 5-426 
MT parameter processing 5-426 
TOD parameter processing 5-426 
common area page teble 
Pages backing 5-269 
common paging data set 
opening 5-197 
communications task 
activation of 5-560 
address space initialization 
5-573, 5-575 
IEAVN701 5-575 
console queueing service 5-585 
description of RIM for 1-7 


4-23, 


initialization 5-102, 5-361, 5-573, 
5-575, 5-582 

IEAVN701 5-575 
RIMs 


console initialization 5-360 
IEAVNPA1L 5-102, 5-360 
IEAVNPC1l 5-162 
IEAVNPO2 5-90 

communications task address space 

See CONSOLE address space 

Communications task initialization 

IEAVVINT 5-581 
component address spaces 
creation 5-547 
IEEMB881 5-547 
CON system parameter 
cross-reference table 1-23 
definition 1-20 
Configuration Management Table 
initialization 5-138 
console 
See also display console, system 
console, operator console 
initialization during NIP 5-361 
initialization for hard copy 5-369 
CONSOLE address space 
cleanup routine 5-579 
initialization 1-10, 1-12, 5-573 
module flow 4-12 
module flow overview 4-23 
console data area 5-378 
CONSOLE statement 5-389 
CON keyword 5-389 
DEL keyword 5-389 
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PKKTAB keyword 5-389 
RNUM Keyword 5-389 
RTME Keyword 5-389 
SEG Keyword 5-389 
UNIT Keyword 5-389 
USE Keyword 5-389 
UTME Keyword 5-389 
initialized 5-389 
Console initialization 
CONSOLE statement 5-389, 5-392, 
5-396, 5-401 
ALTERNATE Keyword 5-396 
AREA Keyword 5-396 
AUTH Keyword 5-396 
CON Keyword 5-396 
DEL keyword 5-396 
LEVEL keyword 5-401 
MFORM Keyword 5-401 
MONITOR Keyword 5-401 
MSGRT keyword 5-401 
PRKTAB keyword 5-401 
RNUM keyword 5-40l 
ROUTCODE Keyword 5-401 
RTME Keyword 5-401 
SEG Keyword 5-401 
UNIT keyword 5-396 
USE keyword 5-396 
UTME keyword 5-401 
DEFAULT statement 5-392 
defaults set for 5-405 
DEFAULT statement 5-405 
HARDCOPY statement 5-405 
INIT statement 5-405 
HARDCOPY statement 5-392 
IEAVNPA1L 5-360 
IEAVN601 5-378 
INIT statement 5-392 
UCM initialization 5-414 
user data validation 5-378 
CONSOLE statement 5-385, 5-392 
CONSOLxx 
initialized 5-389, 5-392 
CON keyword 5-389 
DEL keyword 5-389 
PFKTAB keyword 5-389 
RNUM Keyword 5-389 
RIME keyword 5-389 
SEG keyword 5-389 
UNIT keyword 5-389 
USE keyword 5-389 
UTME keyword 5-389 
processing 5-369 
CONSOLxx member of SYS1.PARMLIB 
description 1-20 
contents supervision 
description of RIM for 1-7 
contents supervisor 
description 5-267 
initialization 5-96 
RIM 
IEAVNPO5 5-96, 5-246 
control registers 
at exit from IEAVNIPO 5-83 
cross memory functions 3 
4, 5 and 7 5-66 
initialization of register 1 5-7 
initialization of registers 14 and 
15 5-136 
initialization of 0 
l, and 149 5-66 
Converting TTR address to CCHHR 
address 5-22 
core blocks 
for system catalog 5-92, 5-106 
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CPAB initialization 5-73 
CPMT 
definition 5-289 
initialization 5-289 
CPU reconfiguration routine 
IEEVCPR 5-523 
CPU work/save area initialization 5-75 
CQE 
initial quick cell pool for 5-583 
initialization 5-576 
set limit for 5-583 
cross memory environment 
ALLOCAS address space 5-628 
CONSOLE address space 5-575 
initialization of control 
registers 5-66 
XMD initialization 5-313 
CSA 
AQAT initialization 5-259 
available for use 5-259 
FBQE initialization 5-259 
initialization 5-50, 5-98, 5-257 
map of 1-29 
Page tables initialized 5-257, 5-259 
CSA system parameter 
cross-reference table 1-23 
definition 1-20 
processing 5-98, 5-257 
CSCB 
description 1-12 
initialized by START command 5-537 
initialized for system address 
spaces 5-546 
initialized for system 
commands 5-553 
initiated by START command 1-12 
used by initiator 5-560 
CSD ianitialization 5-73 
CTC 


adapters 5-289 
ring processor task activated 5-330 
customizing ABEND codes 5-482 
CVAF table 5-423 
CVAF table initialization 5-424 
CVIOQ processing 
See warm start 
CVIO system parameter 
affect on ASM initialization 1-19, 
5-9 
cross-reference table 1-23 
definition 1-20 
CVT 
initialization 5-36, 5-70 
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DAE 
description 1-17 
DAIT 5-628 
DALT 5-628 
DASD 


CMB entries 5-289 
data set opening 5-118 
DCTI initialization 5-291 
duplicate volume serial 
numbers 5-169, 5-500 
initialization 5-90, 5-168 
LPB anitialization 5-291 
mounting 5-116 
path verification 5-169 
testing availability of 5-168, 5-500 
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testans shared ability of 5-168, 
5-5 
UCB initialization 5-168, 5-500 
update DALT use count 5-650 
volume attribute 
initialization 5-515 
with mounted volumes 5-516 
with MSS volumes 5-516 
DAT-off 
initialize the nucleus frames 5-56 
switching mode 5-18 
DAT-off and DAT~on nuclei 
loading 5-36 
DAT-off nucleus 
establishing addressability with 
DAT-on nucleus 5-36 
loading 5-37 
DAT-off to DAT-on linkage table 
initialization 5-36 
DAT-on 
switching mode 5-18 
DAT-on nucleus 5-10 
establishing addressability with 
DAT-off nucleus 5-36 
loading 5-37 
data area 
descriptions 2-l, 2-3 
EQSRD 2-2 
IPL vector table 2-2 
master trace table 2-4 
MQE 2-2 
MQH 2-2 
NIP Console table 2-3 
NIP PARMTAB 2-3 
NIP SPE 2-3 
NIPMOUNT parameter list 2-3 
NIPOPEN parameter list 2-4 
NIPPAREA 2-3 
NIPNTO parameter list 2-4 
NIPNTOR parameter list 2-4 
NLLE 2-2 
NUCMAP 2-2 
NVT 2-3 
QSRCD 2-4 
XQSRD 2-4 
introduction 2-1 
usage table 2-1 
data areas 2-] 
data management 
description of RIM for 1-7 


I 
IEAVNP16 5-104, 5-423 
data set name list initialized 5-639 
data sets 
system 
used in system 
initialization 1-15 
DBVT 
definition 5-289 
initialization 5-289 
DCB 
for I/0 5-88% 
for SYSI].LINKLIB 5-172 
for SYS1.NUCLEUS 5-78, 5-532 
for SYS1.PARMLIB 5-171 


definition 5-159 
use of 5-159, 5-169, 5-500 
pee coments allowed 5-623 


for NIPWNTO 5-88& 

for non-permanent data sets 5-119 
for permanent data sets 5-119 

for system consoles 5-162 


DCQ 
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for SYS1L.LINKLIB 5-172 
for SYS1.NUCLEUS 5-78, 5-532 
for SYS1.PARMLIB 5-171 
debugging aids 
See diagnostic aids 
DEFAULT statement 5-385, 5-392 
defining the address space 1-12 
demand paging rate thresholds 5-286 
DEQ requests 5-352 
DETAIL 
description of SMF keyword 5-632 
device allocation 
EDT 5-624 
IEFABGIO 5-624 
UPL 5-624 
device class 
building the array 5-623 
mountable 5-623 
UCB pointer list 5-623 
device number 
EDT 5-624 
IEFABGIO 5-624 
UCB address 5-624 
device statistics table 
initialization 5-514 
obtain storage for 5-106 
Device support module list 
device-independent display operator 
console support 
See DIDOCS 
DFE initialization 
for ESQA 5-214 
for SQA 5-212 
diagnostic aids 
IEAVNIPM diagnostic trap 
routines 3-1 
IEAVNIPO diagnostic trap 
routines 3-1 
IPL diagnostic techniques 3-1 
NIP Wait State Code X'64' 3-1 
Publications 3-l 
TCB structure 3-l 
TCB Structure After 
Initialization 3-2 
diagnostic trap routines 
IEAVNIPM 3-5 
IEAVNIPO 3-4 
DIDOCS 
initialization 5-562 
Direct Access Device Initialization 
IEAVNPO2 entry point IEAVNPB2 6-9 
I0S RIM —- IEAVNPB2 6-9 
Direct access devices, initialized 5-9] 
Direct DASD initialization 5-90 
Display Allocation Scavenge Routine 
ALLOCAS 5-649 
ASID 5-649 
DALT updating 5-649 
IEFHBG12 5-649 
unit selection 5-649 
display console 
communications task 
initialization 5-582 
DD entry for SYS1.DCMLIB 5-582 
Program function Keys 5-582 
restart text 5-108 
DMB 
definition 5-289 
initialization 5-29] 








domain specification information 
SAR’ in WMST and RMCT 5-282 ) 





used by OPEN macro instruction 5-582 
DSAB initialized 5-581 
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DSNAME 

description of SMF Keyword 5-631 
DSTBL 

initialization 5-195 

use of 5-197 


dummy DFE initialization 5-47 

dump analysis and elimination 
description 1-17 

dump request for master scheduler 


address space 5-634 
Dump Services 
IEAVTSAI 5-358 


initialization 5-358 
DUMP system parameter 


cross-reference table 1-23 
definition 1-20 
use of 1-16 
dumping services 
address space creation 5-356 


address space initialization 
overview 4-20 
description of RIM for 1-7 
RIM 
IEAVNP57 5-102, 5-356 
dumping services address space 
See DUMPSRV address space 
DUMPSRV address space 
initialization 1-10, 1-12, 
5-102, 5-356 
module flow 4-9 
module flow overview 4-20 
duplex paging data set 
opening 5-195 
DUPLEX system parameter 
cross-reference table 
definition 1-20 
duplicate volume serial numbers 
check 5-169, 5-500 
DVT 5-628 
Dynamic Address Translation 


1-14, 


1-23 


5-10 


dynamic pathing initialization 1-9 
ECSA 
AQAT initialization 5-259 
available for use 5-259 
FBQE initialization 5-259 
initialization 5-50, 5-98, 5-257 
map of 1-29 
page tables initialized 5-259 
EDT 
initialization 5-324 


loading into SYS1.NUCLEUS 5-475 
validating Parmlib statement 5-47 
verification routine 5-624, 5-625 
IEFEBSOO0 5-624, 5-625 
EFLPA 
See also LPA 
page frame table 5-269 
Page protection 5-274 
Eligible Device Table 5-475 
eligible restart codes 5-482 
eliglibe device table 5-624 
ELPA 
map of 1-29 
ELSQA 
frames backing 
initialization 
map of 1-27, 


5-58 
5-12, 5-46 
1-28, 1-29 
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EMLPA 
See also LPA 
map of 1-29 
Page protection 5-274 

1-7 


5-424, 


description of RIM for 
exits 5-291 
initialization 5-98, 
RIM 5-98, 5-423 
role during system 
initialization 1-13 
ENF listener 
CVAF as 5-424 
IOS storage manager as 
ISGNASIM as 5-330 
ISGNPGIM as’ 5-327 
SRM RIM as’ 5-289 
ENQ/DEQ macro instruction 
releasing of traps 3-5, 5-95 
setting of traps 3-5, 5-86 
ENQ/DEQ work areas 
initialized 5-179 
obtained 5-179 
EPFP capability 5-71 
EPLPA 
See also LPA 
initialization 
map of 1-29 
Page protection 
rebuilding 5-197 
EQSRD 
data area 2-2 
initialization 5-195, 5-255 
mapping macro description B-l 
use during LPA initialization 
error recovery 
during IPL 1-17, 5-23 
during master scheduler 
initialization 1-18 
during NIP 1-17, 5-66, 5-86 
ESQA 
AQAT initialization 5-214 
AQATINDX initialization 5-214 
DFE initialization 5-214 
frames backing 5-58 
initialization 5-12, 5-44, 
5-211 
map of 1-27, 1-28, 1-29 
page tables initialized 5-214 
ESR SVC table 
initialization 5-13 
ESTAE/STAE macro instruction 
releasing of traps 3-5 
setting of traps 3-5, 5-69, 
use in error processing 1-18 
ETCON macro 5-628 
ETCRE macro 5-628 
FTIB initzralization 5-313 
Event notification facility 
See also ENF 
IEFENFFX 5-328 


5-562 


1-9 


5-255 
5-274 


5-174 


5-96 , 


5-86 


EXCP appendage table 5-424 
EXCP table 5-423 
EXITS 


description of SMF Keyword 5-632 
extended dispatching control 
information 5-284 
extended private area 

map of 1-29 


extended read-only nucleus frames 5-56 
extended read-write nucleus frames 5-56 
external page table 5-255 
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FBQE 
for CSA 5-259 
for ECSA 5-259 
V=V regions 5-50 
FIX system parameter 
cross-reference table 1-23 
definition 1-20 
FLPA 
See also LPA 
page frame table 5-269 
Page protection 5-274 
FRR stack area initialization 5-75 
full function address space 
definition 1-14 
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GCC initialization 5-185 
GDA initialization 5-40, 5-42, 5-212 
generalized trace facility 
See GTF 
global resource processor 
activated 5-330 
global resource serialization 
control block initialization 5-178 
description of RIM for 1-7 
GRS address space 
initialization 5-320 
GRS=NONE 5-344 
initialization 5-94, 5-320 
mainline service routine 
initialization 5-354 
option processor 5-339 
parse setup routine 5-192 
parser 5-181 
function 5-182 
post global resource serialization 
initialization 5-334 
queue merge routine 5-348 
RIMs 5-320 
ITEAVNP23/“ISGNCBIM 5-94 
ISGNCBIM 5-178 
ISGNTASC 5-102, 5-320 
RNL PARMLIB processor 
function 5-186 
vector table extension 
initialization 5-179 
wait for master scheduler 
initialization 5-336 
global resource serialization address 
space 
See GRS address space 
global storage management area 
initialization 5-44 
global VSM cell pool 5-44 
global work/save area 
initialization 5-75, 5-277 
GQHT initialization 5-326 
GRSCAN information 5-350 
graphics devices 5-289 
Greenwich Mean Time 
used in TOD clock 
initialization 5-518 
Greenwich Mean Time —- setting 5-501 
GRPT initialization 5-326 
GRS address space 
IEAVNP33/ISGNTASC 5-320 
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initialization 1-10, 1-12, 5-102, 
5-320 
module flow 4-9 
module flow overview 4-17 
GRS system parameter 
cross-reference table 1-23 
definition 1-20 
processing 5-95, 5-330, 5-339 
GRSCNF system parameter 5-183 
cross-reference table 1-23 
definition 1-20 
processing 5-95, 5-181 
GRSCNFxx member of SYS1.PARMLIB 
description 1-20 
processing 5-181 
GRSRNL system parameter 
cross-reference table 1-23 
definition 1-20 
Processing 5-181 
GRSRNLxx member of SYS1.PARMLIB 
description 1-20 
processing 5-181 
GSDA initialization 5-79 
GTF 
description of RIM for 1-8 
ani tialization 5-104, 5-429 
IEAVNP17 5-104, 5-429 
GVT initialization 5-179, 5-324 
GVTX initialization 5-324, 5-328, 5-354 
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hard copy 
console initialization 5-369 
device initialization 5-369 
log active 5-585 
log initialization 5-369 
record written 5-582 

HARDCOPY statement 5-385, 5-392 
processing 5-369 

HARDCPY system parameter 

sary oo esst ns 5-102 


hardware system area 


initialization 5-58 
page frame table initialization 5-58 
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I/O error 
ASM processing 1-18 


IARMF 

module description 67-4 
IARMI 

module description 6-4 
TARMN 


function 5-269, 5-274 

module description 6-4 
ITARMNRIM 

function 5-269, 5-274 
IARMS 

function 5-270 

module description 6-4 

module flow 4-7 
IARMSRIM 

function 5-270 
ITARMT 
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function 5-272 
module description 6-4 
module flow 4-7 


IARMTRIM 

function 5-272 
ITARMU 

module description 6-4 
IARUF 

function 5-274 
IARUFP 

function 5-274 
TARUINV 

function 5-274 
IARUM 

function 5-269 
ITARUMVF 

function 5-269 
IARVB 


function 5-212, 5-214, 5-259 
module description 6-4 
module flow 4-5, 4-7 
ITARXT 
module description 6-5 
module flow 4-8 
ITARXTIGU 
function 5-289 
ITARXXFT 
function 5-255 
ITATINM3 
function 1-12 
ICBINIT 
module flow 4-13 
ICF catalog initialization 5-93 
ICHP initialization 5-90 
ICHPT 
initialization 5-138, 5-159 
ICHPT initialization 5-139 
ICHSECO0 
module flow 4-14 
TCB structure 3-2 
TCB structure in master scheduler 
region 3-2 
ICS system parameter 
cross-reference table 1-23 
definition 1-20 
processing 5-280 
ICSC initialization 5-280 
ICT initialization 5-277, 5-282 
ITEAAPFxx member of SYS1.PARMLIB 
description 1-20 
IEAAPPOO member of SYS1.PARMLIB 5-424 
IEACMD00 member of SYS1.PARMLIB 
automatic commands 5-426 
IEAFIXxx member of SYS1.PARMLIB 
description 1-20 
IEAICSxx member of SYS1.PARMLIB 
description 1-20 
processing of 5-280 


IEAIPLOO 
function 5-6 
IRIMS 1-5 


order of load 1-5 
loading of 1-3, 1-26 
module description 6-5 
module flow 4-2 

IEAIPLO1 
loading 5-8 
module description 6-5 
SYSRES 5-8 

IEAIPLO2 
brief description 1-5 
diagnostic aids 5-38 
function 5-12, 5-13 

Load DAT-off nucleus 5-12 
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Load DAT-on nucleus 5-12 
module description 5-36, 6-5 
module flow 4-2 
module operation 5-37 

ITEAIPLO3 
brief description 1-5 
function 5-14 
module description 6-5 
module flow 4-2 
IEAIPLOG 
brief description 1-5 
function 5-12, 5-40 

VSM IRIM 5-12 
module description 6-5 
module flow 4-2 
virtual storage map on exit 

from 5-53 
ITEAIPLOS5 
brief description 1-5 
diagnostic aids 5-35 
function 5-10 

Build NUCMAP 5-10 
module description 5-33, 6-6 
module flow 4-2 
module operation 5-34 

IEAIPL06 
brief description 1-5 
function 5-12, 5-53 
Initialize RSM control 
blocks 5-12 
module description 6-6 
module flow 4-2 
PFTE 5-55 
IEAIPLO?7 
brief description 1-5 
function 5-12 

Supervisor control 5-12 
module description 6-6 
module flow 4-2 

LTEAIPL10 
brief description 1-5 
function 5-10 
module description 6-6 
module flow 4-2 
TEAIPL20 
brief description 1-5 
function 5-10 
module description 6-6 
module flow 4-2 
IEAIPL30 
brief description 1-5 
diagnostic aids 5-26 
function 5-10, 5-24 

IEAIPL35 5-10 
module description 5-27, 6-6 
module operation 5-25 

ITEAIPL35 
module description 6-6 
ITEAIPLGO 
brief description 1-5 
function 5-10 

Device support module list 5-10 

module description 6-7 
IEAIPL41 

brief description 1-5 

diagnostic aids 5-32 

function 5-10 

DAT-on nucleus’ 5-10 
module description 5-30, 6-7 
module operation 5-31 

IEAIPL99 
brief description 1-5 
function 5-14 
IPL cleanup 5-14 
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module description 6-7 
module flow 4-2 
virtual storage map on exit 
from 1-27 
IEAIPSxXxx member of SYS1.PARMLIB 
description 1-21 
processing of 5-280 
IEALPAxx member of SYS1.PARMLIB 
description 1-21 
IEANUCOx 
See DAT-on nucleus 
IEAOPTxx member of SYS1.PARMLIB 
description 1-21 
Processing 5-278 
IEAOPTO1] function 5-340 
IEAPAKOO member of SYS1.PARMLIB 


contents 5-247 

processing of 5-247 
IEAPMNIP 

function 5-532 


mapping macro 8B-l 

use of 5-185, 5-195, 5-199 
IEAPPNIP mapping macro B-l 
IEAPSPIO mapping macro B-]l 
IEAQCDSR 

function 5-430 
IEASVCxx member of SYS1.PARMLIB 

description 1-22 
IEASYSxx 

RDE parameter 5-423 

RER parameter 5-423 
IEASYSxx member of SYS1.PARMLIB 

description 1-22 

operator use of 1-24 
IEASYSOO member of SYS1.PARMLIB 


function 1-19, 1-24 
processing 5-171 
IEAVAPOO 
brief description of volume attribute 
RIM 1-8 
function 5-106, 5-515 


module description 6-7 
module flow 4-ll 


IEAVAROO 
module flow 4-15, 4-16, 4-17, 4-20, 
4-24, 4-26, 4-27 
ITEAVEBBR 
function 5-313 
IEAVECMS 
function 5-315 
IEAVEDAT 
See DAT-off nucleus 
IEAVEMCR 
function 1-12, 5-541 
module flow 4-15, 4-16, 4-17, 4-20, 
4-24, 4-25, 4-27, 4-30 
IEAVEMIN 
function 1-12 
module flow 4-30 
IEAVEMRQ 
function 1-12, 5-539 
module flow 4-30 
IEAVETAC 
function 1-12 
module flow 4-16 
IEAVETAI 
module flow 4-16 
IEAVETSI 
module flow 4-16 
IEAVIPL 
IPL service routines in C-l 
IEAVMQWR 


attached 5-578 
module flow 4-23 
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IEAVM200 
module description 6-7 
IEAVNIPM 
brief description 1-6 
diagnostic trap routines 3-5 
function 5-83, 5-84 
loading of 5-78 
module description 6-7 





2 


module flow 4-4, 4-15, 4-16, 4-17, 
4-20 
NIP service routines in D-l 
use of 5-361 
IEAVNIPM Diagnostic Trap Routines 3-5 


IEAVNIPX 
brief description 1-6 


brief description of NIP RIM 1-7 


function 5-108, 5-531 
module description 6-8 
module flow 4-ll 
virtual storage map on exit 
from 1-29 
IEAVNIPO 
brief description 1-6 
diagnostic trap routines 3-4 
function 5-66 
module description 6-8 
module flow 4-2 
real frames backing 5-58 
virtual storage map on exit 
from 1-28 
IEAVNIPO Diagnostic Trap Routines 
I EAVNPAIL 


3-4 


brief description of communications 


task RIM 1-7 
diagnostic aids 5-363 
function 5-102, 5-360 
console initialization 
initialize communications 


task 5-102 
module description 5-360, 6-8 
module flow 4-9 
module operation 5-361 


IEAVNPA2 5-90 
function 5-158 
module description 6-8 
module flow 4-4 
IEAVNPA27 
Diagnostic aids 
wait state codes 
function 5-138 
module description 
Module flow 5-142, 
5-148, 5-150, 5-154 
channel path information 
CMT initialization 5-148 
Configuration information 
ICHPT initialization 5-150 


5-140 
5-140 


5-138, 
5-144, 


Side information 5-145 
module operation 5-139 
IEAVNPAS5 
function 5-174 


module description 6-8 
module flow 4-5 
IEAVNPA6 


brief description of RIM RIM 1-6 


5-132 
5-130 


diagnostic aids 
function 5-88, 


module description 5-130, 6-8 
module flow 4-4 
module operation 5-131 


IEAVNPA8S 


brief description of VSM RIM 1-7 


5-210 
6-9. 


function 5-96, 
module description 
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5-157 
5-145, 


5-144 
5-154 
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module flow 4-5 
IEAVNPB2 5-90 
function 5-90, 5-168 
test direct access devices 5-90 
module description 6-9 
module flow 4-4 
ITEAVNPB8 
brief description of VSM RIM 1-7 
function 5-98 
module description 6-9 
module flow 4-7 
ITEAVNPC1 
brief description 1-6 
diagnostic aids 5-164 
function 5-90, 5-162 
NIP consoles initialization 5-90 


module description 5-162, 6-9 

module operation 5-163 
ITEAVNPC2 

function 5-500 


module description 6-9 

module flow 4-10 
IEAVNPCS5 

function 5-247 

module description 6-9 

module flow 4-7 
IEAVNPC8& 

function 5-197, 5-247 

module description 6-9 

module flow 4-5 
ITEAVNPDI 

diagnostic aids 

module description 

module operation 
ITEAVNPD1 

brief description of dumping services 

RIM 1-7 
function 5-100, 5-294 
ABDUMP initialization 

module description 6-10 

module flow 4-8 
ITEAVNPD2 

brief description of dumping services 

RIM 1-7 
function 5-100 
SVC dump initialization 

module description 6-10 

module flow 4-8 
ITEAVNPD6 

brief description of RIM RIM 1-6 

function 5-100, 5-264 

module description 6-10 

module flow 4-8 


5-300 
5-296 
5-298 


5-100 


5-100 


IEAVNPD8 
brief description of RSM RIM 1-7 
function 5-98, 5-268 


module description 6-10 
module flow 4-7 

ITEAVNPE6 
brief description of service 

processor RIM 1-6 

function 5-88, 5-128 
module description 6-10 
module flow 4-4 


ITEAVNPE8& 
brief description of RSM RIM 1-7 
function 5-94, 5-176 


module description 6-10 
module flow 4-5 
ITEAVNPF2 
function 5-106, 5-513 
initialize IOS options 
module description 6-11 
module flow 4-10, 4-11 


5-106 
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ITEAVNPF5 
brief description of PC/AUTH RIM 1-7 
function 1-12, 5-102, 5-308 
PC/AUTH address space 5-102 
module description 6-l1l 
module flow 4-9, 4-15 
ITEAVNPIM 
diagnostic aids 5-126 
module description 5-124 
module operation 5-125 
IEAVNPIPO 
initializae the DCB 5-80 
initialize the DEB 5-80 
ITEAVNPM2 
function 5-110 


module description 6-ll 
use of 5-532 


TEAVNPM3 
function 5-116 
module description 6-11 
use in 5-247 
use of 5-171, 5-172 
IEAVNPM4 
function 5-120 


module description 6-11 


use of 5-171, 5-185, 5-514 
IEAVNPM5 

module description 6-11 
ITEAVNPST 

module description 6-11 
ITEAVNPSS5 


module description 6-12 
module flow 4-7 
IEAVNPX1 
brief description 1-6 
brief description of NIP RIM 1-7 
function 5-100 
cleanup 5-100 
module flow 4-8 
IEAVNPOO 
brief description of reconfiguration 
RIM 1-6 
function 5-108 
module description 6-12 
module flow 4-11 
ITEAVNPOL] 
module flow 4-4 
ITEAVNPO2 
brief description of IOS RIM 1-6 
Direct Access Device 
Initialization 6-9 
Entry point IEAVNPA2 6-8 
entry point IEAVNPB2 6-9 
function 5-90 
non-DASD initialization 5-90 
IEAVNPA2 5-90 
IEAVNPB2 5-90 


module description 5-158 
IEAVNPA2 5-158 
IEAVNPO3 


brief description 1-6 
brief description of NIP RIM 1-7 
function 5-92, 5-170 
building the APF table 5-92 
building the LLT 5-92 
opening SYS1.PARMLIB 5-92 
module description 6-12 
module flow 4-5 
TEAVNPO0G 
See also ILRASRIM 
module description 6-12 
module flow 4-5 
IEAVNPO5 5-96 
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brief description of contents 
Supervision RIM 1-7 


function 5-96, 5-246 
initialize contents 
Supervisor 5-96 
module description 6-12 
module flow 4-7 
IEAVNPO06 
brief description of MCH RIM 1-6 
function 5-88, 5-134 
module description 6-13 
module flow 4-4 
IEAVNPO8 
module description 6-13 
IEAVNPO09 


brief description of supervisor 
control RIM 1-7 
function 5-100, 5-266 
initialize supervisor 
control 5-100 
module description 6-13 
module flow 4-9 
IEAVNPLA 
function 5-93 
module description 6-13 
IEAVNP1B 
brief description of VSM RIM 1-7 
function 5-106 
close system catalog 5-106 
module description 6-13 
module flow 4-11 
IEAVNPLF 
brief description of SRM RIM 1-7 
function 5-98, 5-288 
module description 6-13 
module flow 4-8 
IEAVNP1O 
brief description of SRM RIM 1-7 
function 5-98, 5-276 
module description 6-14 
module flow 4-8 
IEAVNPI11L 
brief description of VSM RIM 1-7 
function 5-92 
opening the system catalog 5-92 
module description 6-14 
module flow 4-4 
IEAVNP12 
module description 
IEAVNP13 
brief description of master scheduler 
initialization RIM 1-8 
function 5-104, 5-425 
initialize master scheduler 
module description 6-14 
module flow 4-10 
IEAVNP14 
function 5-96 
initialize ASM 5-96 


6-14 


5-104 


module description 6-14 

module flow 4-6 
IEAVNPL5 

See also IEAVAPOO 

module description 6-14 


module flow 4-11 
IEAVNP16 
brief description of data management 
RIM 1-7 
function 5-104, 5-423 
build appendage name table 
module description 6-14 
module flow 4-10 
IEAVNP17 
brief description of GIF RIM 1-8 


5-104 
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function 5-104, 5-429 
initialize GIF 5-104 
module description 6-15 
module flow 4-10 
IEAVNP18 
brief description of master scheduler 
initialization RIM 1-8 
Diagnostic Aids 5-434 
function 5-431 
module description 5-431, 6-15 
Module Operation 5-433 
Process Flow 5-435 
IEAVNP19 
brief description of MSSC RIM 1-8 
function 5-104, 5-499 
initialize mass storage 
controllers 5-104 
module description 6-15 
module flow 4-10 
IEAVNP20 
brief description of master scheduler 
initialization RIM 1-8 
Diagnostic Aids 5-504 
function 5-106, 5-501 
CLOCKxx member processing 5-106 


Module Description 5-501, 6-15 
Module Operation 5-503 
Process Flow 5-507 
IEAVNP23 
See also ISGNCBIM 
module description 6-15 
module flow 4-5, 4-17 
IEAVNP25 
diagnostic aids 5-228 


function 5-96 
process SVC PARMLIB 5-96 
module description 5-222, 5-223, 


6-15 

module operation 5-226 
IEAVNP27 

function 5-90 


ICHP initialization 5-90 


subchannel initialization 5-90 


module description 6-15 
IEAVNP33 

See also ISGNTASC 

module description 6-16 


module flow 4-9 
IEAVNP33/ISGNTASC 5-320 


function 5-102 
initialize global resource 
serialization 5-102 
IEAVNP47 


brief description of ENF RIM 1-7 
module description 6-16 
module flow 4-7 
IEAVNP51 
brief description of system trace 
RIM 1-7 
function 5-102, 5-318 
initialize system trace 
module description 6-16 
module flow 4-9, 4-16 
IEAVNP 57 
brief description of dumping services 
RIM 1-7 
function 1-12, 5-102, 5-356 
initialize dumping services 
module description 6-16 
module flow 4-9, 4-20 
IEAVNP76 
brief description 1-6 
brief description of logrec 
initialization RIM 1-7 


5-102 


5-102 
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module description 6-16 
module flow 4-4 
IEAVN600 
diagnostic aids 5-371 
function 5-369 
module description 5-369, 6-16 
module operation 5-370 
IEAVN601 
ALTERNATE Keyword 5-380 
AREA keyword 5-38l 
CONSOLxx initialization 
DEVNUM keyword 5-379 
diagnostic aids 5-383 
function 5-378 
LEVEL keyword 5-380 
MFORM keyword 5-380 
module description 5-378, 6-16 
module operation 5-379, 5-380 
MONITOR keyword 5-381 
ROUTCODE Keyword 5-380 
SUBSYSTEM keyword 5-379 
IEAVN602 
diagnostic aids 5-388 
function 5-385 
module description 5-385, 6-17 
module operation 5-386 
validate user data 5-385 
CONSOLE statement 5-385 
DEFAULT statement 5-385 
HARDCOPY statement 5-385 
INIT statement 5-385 
IEAVN603 
module description 6-17 
IEAVN604 
diagnostic aids 5-391 
function 5-389 
module description 5-389, 6-17 
module operation 5-390 
IEAVN610 
diagnostic aids 5-394 
function 5-392 
module description 5-392, 6-17 
module operation 5-393 
IEAVN611 
diagnostic aids 5-398 
function 5-396 
module description 5-396, 6-17 
module operation 5-397 
IEAVN612 
diagnostic aids 5-403 
function 5-401 
module description 5-G01, 6-17 
module operation 5-402 
IEAVN613 
diagnostic aids 5-408 
function 5-405 
module description 5-405, 6-18 
module operation 5-406 
IEAVN614 
diagnostic aids 5-417 
function 5-414 
module description 5-414, 6-18 
module operation 5-415 
IEAVN700 
function 1-12, 5-573 
module description 6-18 
module flow 4-12, 4-23 
IEAVN701 
function 5-575, 5-578 
module description 6-18 
module flow 4-23 
ITEAVN702 
function 5-577, 5-579 
module description 6-18 
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module flow 4-23 
IEAVN8&00 

moagule description 6-19 
IEAVRCOM 

use in TOD clock 

initialization 5-518 

IEAVRITO 

TCB structure 3-2 
IEAVRTOD 

function 5-108, 5-517, 5-523 

module description 6-19 

module flow 4-11 
IEAVRTST 

use in TOD clock 

initialization 5-518 

IEAVTABI 

module description 6-19 

module flow 4-8 
IEAVTACR 

function 5-135 
IEAVTJBN 

function 5-558 
IEAVTMSI 

function 5-633 

module description 6-19 

module flow 4-13 
ITEAVTMTC 

function 5-635 

module description 6-19 

module flow 4-13 

TCB structure 3-2 
IEAVTRET 

function 5-634 

module description 6-19 

module flow 4-13 
IEAVTSAI 

function 5-358, 5-536 

module description 6-20 

module flow 4-20 
IEAVTSAS 

function 5-357 

module description 6-20 

module flow 4-20 
IEAVTSDD 

function 1-16 

module description 6-20 

module flow 4-8 
IEAVTSDI 

module description 6-20 

module flow 4-8 
IEAVTSDT 

function 5-634 

module description 6-20 

module flow 4-13 
IEAVVINT 

function 5-562, 5-577, 5-581 

module description 5-581, 6-20 

module flow 4-23 

module operation 5-583 


TEAVVMSR 

function 5-430 
IEAVXECO 

module flow 4-16 
IEAVXECR 


function 5-315 

module flow 4-15, 4-16 
IEAVXECO 

function 5-315 

module flow 4-15 
IEAVXEPM 

function 5-311 

module description 6-21 
IEAVXMAS 

function 5-310, 5-536 
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module description 6-21 

module flow 4-15 

use in PC/AUTH initialization 5-309 
IEAVXMIN 

function 1-12 

module flow 4-30 
IEAVXSEM 

function 5-315 

module description 6-21 
IECIOSxx member of SYS1.PARMLIB 

description 1-20 

processing 5-514 
IECVCPRM 5-76 

module flow 4-2 
IECVIOSI 

module description 6-21 

module flow 4-13 
IEECVGCI 

function 5-562 

module description 6-21 

module flow 4-23 

use 1n communications task 

initialization 5-585 
IEECVUCM 

module description 6-2] 
IEEJSWT 

module flow 4-28 
IEEMB803 

function 5-570, 5-583 

module description 6-2] 

module flow 4-14 

TCB structure 3-2 
IEEMB809 

module description 6-22 

module flow 4-12 
IEEMB820 

function 1-12, 5-629 

module description 6-22 

module flow 4-13, 4-26 

TCB structure 3-2 
IEEMB821 

function 5-630 

module flow 4-26 
IEEMB822 

module flow 4-26 
IEEMB823 

module flow 4-26 
IEEMB829 

module flow 4-26 

TCB structure 3-2 
IEEMB839 

module flow 4-26 
IEEMB842 

module flow 4-26 
IEEMB850 

function 5-562 

module flow 4-12 
IEEMB860 

function 1-9, 1-15 

module description 6-23 

module flow 4-13, 4-25, 4-26, 4-29 

TCB structure 3-2 


IEEMB875 

function 5-635 
IEEMB878 

function 1-15, 5-644 
IEEMB881l 


components using 1-10, 1-12, 1-13 
function 5-535 

module description 6-23 

module flow 4-13, 4-15, 4-16, 4-1/7, 
G-20, 4-23, 4-24, 4-26, 4-28, 4-30 
reason codes 5-544 

return codes 5-544 
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use in ALLOCAS initialization 5-626 
use in CONSOLE initialization 5-574 
use in DUMPSRV initialization 5-357 
use in GRS address space 5-320 
use in initializing system address 
spaces 4-30 
use in PC/AUTHR initialization 5-309 
use in system address 
initialization 5-548 
IEEMB88&2 
function 1-15, 5-646 
IEEMB883 
function 5-315, 5-545, 5-548, 5-580 
input parameter list 5-337 
module description 6-23 
moduie flow 4-15, G-16, 4-18, G-23, 
IEEMB884 
loading 5-428 
IEEMB887 
module flow 4-17 
process SYS1.PARMLIB member 5-192 
IEEMB888 
brief description of 1-8 
Diagnostic Aids 5-442 
function 5-438 
scanning PARMLIB members 5-438 
Module Description 5-438, 6-24 
Module Operation 5-440 
Process Flow 5-444 
IEEPRTN2 
function 5-558 
module flow 4-28 
IEEPRWI2 
function 1-13, 5-359, 5-550 
module description 6-24 
module flow 4-15, 4-16, 4-17, 4-20, 
4-23, 4-24, 4-26, G-2/7, 4-28, 4-31 
IEESB601 
module flow 4-28 


IEESB605 

module flow 4-15, 4-16, 4-17, 4-20, 

4-249, 4-27, 4-28 
IEESB641 

function 5-558 
IEESB645 

function 5-556 
IEESB665 

loading 5-550 
IEESB670 

function 5-556 
IEEVCPR 


CPU reconfiguration routine 5-523 
function 5-108 
Initialization of non-IPL 

processors 5-524 
module description 6-24 
module flow 4-1l 

IEEVEMCR 
module flow 4-26 
TCB structure 3-2 

IEEVIOSR 
function 5-522 

IEEVIPL 
function 1-9, 1-14, 5-559 
module description 6-24 
module flow 4-25 
TCB structure 3-2 

IEEVJCL 
function 5-553 
module flow 4-28 

IEEVLDWT 
function 5-578 

IEEVMNT1 
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function 5-552 
module flow 4-28 
IEEVMNT2 
module flow 4-28 
IEEVORGI 5-138 
IEEVSMSG 
module flow 4-28 
IEEVSTAR 
function 5-552 
module flow 4-28, 4-3l 
IEEVWAIT 
function 1-9, 5-545, 5-549 
module description 6-24 
module flow 4-14, 4-23, 4-24, 4-25, 
G-2/7, 4-30, 4-31 
TCB structure 3-2 
IEE0603D 
function 5-520 
IEE0803D 
function 1-12 
IEFABGE6 
module description 6-25 
IEFABGIE 
Diagnostic Aids 5-478 
Module Description 5-475 
Module Operation 5-476 
Process Flow 5-480 
IEFABGIO 
function 1-12, 5-623 
module description 6-25 
module flow 4-12, 4-24 
IEFEB400 5-625 
module description 6-25 
module flow 4-12 
IEFENFFX 5-329 
function 5-327, 5-328, 5-330, 5-423 
module description 6-26 
module flow 4-18 
use in CVAF initialization 
IEFENFNM 
module description 6-26 
module flow 4-18 
IEFENFWT 
module description 
module flow 4-13 
IEFHBSI1 
function 5-627, 5-628 
started task control 
processing 5-627 
module description 6-26 
module flow 4-24 
IEFHBGI2 
module description 
module flow 4-14 
IEFHBS10 
function 5-650 


5-424 


6-26 


6-27 
module description 6-2/7 
module flow 4-14 

IEFIB600 
module flow 4-25, 4-27 

IEFJESDM 
module description 6-27 

IEFJMSFC 
module description 6-27 

IEFJRECM 
address located 5-604 

IEFJREQF 
address located 5-604 

IEFJSBLD 
abends 5-622 
disabling selected SSVT 

functions 5-614 
enabling selected SSVT 
functions 5-614 
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error recovery 5-622 


function 
5-609 

module description 

module flow 4-12, 
IEFJSDTN 

module flow 4-27 
IEFJSIMM 

module description 
IEFJSIMN 5-643 

function 

module description 
IEFJSINT 

function 5-603 


5-609, 5- 


1-14, 1-15, 5-603, 5-605, 


6-28 
4-29 


6-28 


610, 5-612, 5-646 
6-28 


subsystem communication table 


initialization 

module description 

module flow 4-12 
IEFJSIN2 

function 

module description 

module flow 4-14, 
IEFJSSNT 

loaded 5-641 

module flow 4-12, 

processing 5-641 
IEFJSUBI 

module flow 4-25, 
LEFJSWT 

function 5-558 
IEFNB903 

module flow 4-25, 
IEFPPT 


Diagnostic Aids 5- 


function 5-457 

IEEMB887 5-457 

IEEMB888& 5-457 

Module Description 

Module Operation 

Process Flow 
IEFQBINT 

module description 

module flow 4-12 
IEFQB550 

module description 
IEFRCSTP 


Diagnostic Aids 5- 


Function 5-482 
Module Description 
6-29 

Module Operation 


5-603 
6-28 


1-15, 5-641 


6-28 
4-29 


4-29 


4-27 


4-27 
460 


5-457, 6-29 


5-459 
5-462 


6-29 


6-29 
486 
5-482, 5-483, 


5-484 


NORESTART codes 5-482 

Process Flow 5-488 

RESTART codes 5-482 
IEFSD060 

TCB structure 3-2 
IEFSD064 

function 5-558 
IEFSD160 

module flow 4-25, 4-27 
IEFSD161 

module flow 4-27 
IEFSD162 

module flow 4-25, 4-27 
IEFSD263 

module flow 4-25, 4-27 
IEFSJINT 

module description 6-29 


module flow 4-13 
IEFSMFIE 


function 5-630 


IEFSSNxx member of SYS1.PARMLIB 


1-22 
5-426, 


description 
processing 


1987 


5-641, 5-644 
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IEFSSREQ 

function 5-556 
IEFVH1 

module flow 4-25, 4-27 
IEFW21SD 


module flow 4-25, 4-27 
EL 


initialization 5-558 
used by initiator 5-560 
IFAEASIL 
function 5-550 
IFASMF 
module description 6-29 
module flow 4-26 
IFASTART 
module description 6-30 
module flow 4-26 
IFCDIPO0O member of SYS1.LOGREC 
function 1-19 
IGFPBUCR 
function 5-136 
module description 6-30 
module flow 4-4 
IGFPEMER 
work area storage 5-134 
IGFPEXIT 
module flow 4-4 
IGFPTERM 
function 5-574 
IGVEAAQA 
function 5-212, 5-214, 5-257 
module flow 4-5 
IGVGVRGN 
function 5-534, 5-550 
IGVNIPCR 
function 5-289 
module description 6-30 
module flow 4-8 
IHAIVT mapping macro A-l 
IHANVT mapping macro B-l 
IKJEFLA 
function 5-552 
module flow 4-28 
IKJEFXSR 
function 5-562 
module description 6-30 
module flow 4-12 
ILRASRIM 
brief description of ASM RIM 1-7 
function 5-96, 5-194, 5-197 
module description 6-30 
module flow 4-5 
ILRASRM1 
brief description of ASM RIM 1-7 
function 5-96, 5-216 
module description 6-530 
module flow 4-6 
ILRASRM2 
function 5-196 
module description 6-31 
module flow 4-5, 4-6 
open processing 5-218 
Parse data set names 5-216 
ILREQSRD mapping macro B-l 
ILRIMMSG 
function 5-195, 5-197, 5-198 
module description 6-3] 
module flow 4-5, 4-6 
ILRMSGOO 
function 5-639, 5-640 
ASM message module 5-639 
module description 6-31 
ILROPSOO 
function 5-200 
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module description 6-3l 
module flow 4-5, 4-6 
ILRPREAD 
function 5-204, 5-220, 5-255 
module description 6-32 
module flow 4-5, 4-6, 4-7, 4-14 
ILRQSRCD mapping macro B-l 
ILRQSRIT 
function 5-174, 5-254 
module description 6-32 
module flow 4-7 
ILRTMIOO 
function 5-637 
module description 6-32 
module flow 4-14 
ILRTMIOIL 
module description 6-32 
ILRTMRLG 
module description 6-32 
module flow 4-14 
ILRXQSRD mapping macro B-l 
INFOTAB 
building 5-247 
overlaid by LPDE 5-247 
INIT statement 5-385, 5-392 
initial program loader 
function 5-6 
initialization part 2 
auxiliary storage management 
function 5-216 
initialization records 
SMF 5-630 
initiator 
master scheduler function 
overview 4-25 
role in master scheduler 
initialization 
module flow 4-13 
role in system initialization 1-9 
use in system initialization 5-560 
Interface to General Parmlib Scan 
Routines. 
description of RIM for 1-8 
IEEMB8&8& 1-8 
internal readers 
contents of data sets 1-17 
device allocation for 4-25 
internal text block 5-514 
interrupt subclass 
set for paging and swapping 5-201 
INTERVAL 
description of SMF keyword 5-632 
IOCMSCQE 
function 5-291 
Ios 
buffers initialized 5-76 
description of RIM for 1-6 
IEAVNPO2 5-158 
IEAVNPA2 5-158 
initialization 5-90, 5-513 
RIM 
IEAIPLO3 5-14 
RIM 


Ss 
IEAVNPA2 5-90 
IEAVNPB2 5-90, 5-168 
IEAVNPF2 5-106, 5-513 
IOS system parameter 
cross-reference table 1-23 
definition 1-20 
Processing 5-106, 5-513 
IOSB 
for ASM read/write routine 5-205 
IOSLOOK macro instruction 
use of 5-185 
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IOSRMIHT 

function 5-514 

module description 6-33 

module flow 4-13 

TCB structure 3-2 
IOSROUTG 

module flow 4-13 

TCB structure 3-2 
IOSVCPRM 5-76 

module flow 4-2 
IOSVNPTH 5-515 

function 5-161, 5-169, 5-500, 5-516 

module description 6-33 

module flow 4-4 
IOSVSUCB 

use of 5-516, 5-650 
PL 


data area during 2-l 
diagnostic trap techniques 3-3 
error recovery during IPL 1-17 
IVT data area 2-2 
macro instructions A-l 
module flow overview 4-2 
service routines C-l 
supervisor calls 
list of 1-3 
processing 5-16 
SVC stack area 3-3 
description 3-3 
initialization 5-16, 5-18 
system data sets used during 1-15 
types of 1-18 
workspace 5-7 
IPL Diagnostic Trap Techniques 3-3 
IPL module 
See ITEAIPLOO 
IPL phase of initialization 
overview 1-3 
IPL processor 
control register 
initialization 5-136, 5-267 
EPFP capability 5-71 
MCH control blocks 
initialization 5-136 
message buffer pool 
initialization 5-135 
model dependent values 5-286 
PSA 5-76 
store information for 
Initialization 5-105 
TOD clock initialization 1-25, 5-68, 
5-84, 5-108, 5-517, 5-523 
IPL resource initialization module 
See IRIM 
IPL RIMs 
module name versus RIM name 6-1 
Pigeon ogee Routines 


L svc 0 1-4 
IPL SVC 1 1-4 
IPL SVC 10 1-4 
IPL SVC 11 1-4 
IPL SVC 2. 1-4 
IPL SVC 3. 1-4 
IPL SVC G 1-4 
IPL SVC 5 1-4 
IPL SVC 6 1-4 
IPL SVC 7 1-4 
IPL SVC 8 1-4 
IPL SVC 9 1-4 


IPL storage validation routine 
function 5-10 
IPL WIOR facility module 5-24 
peepee eae recorder initialization 1-9, 
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IPLWTO 
macro A-l 
IPLWTO service routine 
function C-1l 
IPS system parameter 
cross-reference table 1-23 
definition 1-21 
function 1-25 
processing 5-280 
IPSYNTAB 5-278 
IRARMANL 
function 5-278, 5-280 
module description 6-33 
module flow 4-8 
IRARMCHM 
function 5-289 
IRARMCPU 
function 5-277 
module description 6-33 
module flow 4-8 
IRARMICS 
function 5-280 
module description 6-33 
module flow 4-8 
IRARMIPM 
module description 6-33 
IRARMIPS 
function 5-280 
module description 6-33 
module flow 4-8 
IRARMOPT 
function 5-278 
module description 6-34 
ce flow 4-8 


IEAIPLO2 5-12 
IRIM suffix list 
See ITEAIPLOIL 
IRIMs 
definition 1-3 
description of modules 1-5 
IEAIPLO2 5-13, 5-36 
IEAIPLO3 5-14 
IEAIPLOG 5-12, 5-40 
IEAIPLO5 5-10, 5-33 
NUCMAP 5-10 
IEAIPLO6 5-12, 5-53, 5-54 
IEAIPLO7 5-12 
IEAIPL30 5-10, 5-24 
IEAIPL35 5-24 
IEAIPLGO 5-10 
IEAIPLG1 5-10, 5-30 
IEAIPL99 5-14 
loading 5-10 
location 5-7 
module flow overview 4-2 
order loaded by IJEAIPLOO 1-5 
Program organization 1-5 
ISCRCV 
ISGNRTY1 5-342 
ISGNRTY2 5-342 
ISGBCI 
vee ae” 5-338, 5-339, 5-340, 5-348, 
module description 6-34 
module flow 4-19 
perform STARTPOP 5-344 
ISGBSR 
function 5-350 
ISGBTC 
function 5-331 
module description 6-34 
module flow 4-18 
ISGCMDR 
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function 5-331 
module description 6-34 
module flow 4-18 
ISGCQMRG 
function 5-339, 5-340, 5-348 
module description 6-35 
module flow 4-19 
ISGCRCV 
function 5-327, 5-337, 5-339, 5-347 
module description 6-35 
module flow 4-19 
ISGCRST 
function 5-349 
module description 6-35 
ISGCTASC 
brief description of global resource 
serialization RIM 1-7 
ISGGQSOl 
function 5-348 
ISGGQSRV 
module description 6-35 
module flow 4-19 
ISGGQS01 
function 5-347 
ISGGQS03 
function 5-352 
ISGGQWBC 
SQA version released 5-327 
ISGGQWBO 
function 5-350, 5-355 
module flow 4-19 
ISGGRNLV 
module description 6-36 
module flow 4-17 
ISGGRPOO 
function 5-331 
module description 6-36 
module flow 4-19 
ISGGSRI 
function 5-328 
ISGGSRVI 5-329 
function 5-327, 5-328, 5-354 
module description 6-36 
module flow 4-18 
ISGJPARM 
error routine RDRTNEOR 5-193 
function 5-181, 5-182 
global resource serialization 
parser 5-182 
module description 6-36 
module flow 4-17 
ISGMSGO00 
function 5-327, 5-342 
module description 6-36 
module flow 4-19 
ISGNASIM 
establish recovery 5-327, 5-331 
function 5-322 
module description 6-37 
module flow 4-18, 4-19 
ISGNCBIM 
brief description of global resource 
serialization RIM 1-7 
function 5-94, 5-178 
module description 6-3/7 
module flow 4-5, 4-17 
ISGNGRSP 
function 5-338 
module description 6-37 
module flow 4-19 
ISGNPARS 
function 5-192 
module description 6-37 
module flow 4-17 
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ISGNPGIM 
establish recovery 5-334 
function 5-330, 5-334 
module description 6-3/7 
module flow 4-18 
ISGNRNLP 
function 5-181, 5-186 
module description 6-38 
module flow 4-17 
ISGNTASC 5-320 
function 1-12, 5-320 
module description 6-38 
module flow 4-9, 4-17 
ISGNWMSI 
function 5-336 
module description 6-38 
module flow 4-18 
ISGQSCAN 
function 5-348, 5-349 
module description 6-38 
module flow 4-19 
ISGSALC 
module description 6-38 
module flow 4-18 
ISGSGLH 
module flow 4-18 
ISVCCNVT 
description 1-4 
Processing 5-22 
TTR address conversion 5-22 
ISVCCSEG 
description 1-4 
processing 5-22 
build segments 5-22 
. builds page tables 5-22 
ISVCDAT 
description 1-4 
processing 5-18 
ISVCEXIT 
description 1-4 
processing 5-18 
ISVCFIND 
description 1-4 
processing 5-20 
ISVCLOAD 
description 1-4 
processing 5-20 
ISVCPGFX 
description 1-4 
Processing 5-18 
ISVCSSCH 
description 1-4 
processing 5-22 
starts IPL subchannel 5-22 
ISVCSTOR 
description 1-4 
processing 5-20 
ISVCSYNC 
cescription 1-4 
Processing 5-22 
PSW build 5-22 
ISVCWAIT 
description 1-4 
processing 5-16 
ISVCXDAP 
description 1-4 
Processing 5-16 
IVT 
description 2-2, 5-7 
freed 5-8l 
initialization 5-8, 5-42 
location 5-7 
mapping macro description A-l 
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JCL 


card images in MSTJCLOO 1-16 
MSTRJCL member of SYSI.LINKLIB 5-603 
supplied for MOUNT command 5-553 
text written to system data 
set 5-558 
JCLS 
use by STC 5-556 
JES 
initialization of control 
blocks 5-604 
output class 
for system log data sets 
overview of initiation 4-27 
JES name table 
use in subsystem interface 
initialization 5-603 
JESALLOP field 5-628 
JESCT 5-425 
IEFJSINT 5-603 
subsystem interface 
initialization 5-603 
initialization 5-603, 5-609 
initialization of 5-604 
SWA management routine 
addresses 5-560 


5-428 


JESCT initialization 5-426 
JES3 address space 

See JES3AUX 
JES3AUX address space 
initialization 1-10, 1-12 


Job entry subystem communication table 
JESCT 5-603 

JSCB 
initialized for master 
scheduler 5-534 
initialized for system address 
spaces 5-546 


used by OPEN macro instruction 5-582 


JSEL initialization 5-553 
JSIPL 

initialization 5-615 
JSWA initialization 5-556 
JSXL initialization 5-553 


JWT 
description of SMF keyword 5-631 
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Keywords for SMF 5-631 


LCCA initialization 5-75 

LCCAVT initialization 5-73 

LDA initialization 5-48, 5-49 

GVT 
initialization 5-220 
use of 5-220 
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limited function address space 
definition 1-13 
link list 
See also LNKLSTxx 
table 5-172 
list of abbreviations E-1l 
LISTDSN 
description of SMF keyword 5-631 
LLT initialization 5-172 
LLT», building 5-92 
LNK system parameter 
cross-reference table 1-23 
definition 1-21 
processing 5-92, 5-171 
LNKAUTH system parameter 
cross-reference table 1-23 
definition 1-21 
LNKLSTxx member of SYS1.PARMLIB 5-172 
description 1l1-2l 
LOAD function 
operator activation of 1-3 
loading DAT-off and DAT-on nuclei 5-36 
local data area initialization 5-48 
local paging data sets 
opening 5-218 
local VSM cell pool initialization 5-48 
local work/save area 
initialization 5-75 
LOCATE SVC 
description of NIPSVC 3-6 
releasing of traps 5-534 
setting of traps 5-86 


SVC table entry initialization 5-534 
log data set 

LOGLMT system parameter 5-428 

maximum number of messages 5-428 


output class 5-428 
LOGCLS system parameter 
cross-reference table 1-23 
definition 1-2l 
processing 5-428 
LOGLMT system parameter 
cross-reference table 1-23 
definition 1-21 
processing 5-428 
logrec initialization 
description of RIM for 1-7 
LOGREC record 
L obtain storage for extra 5-134 
PA 
contents 5-247 
directory 5-247 
hash value 5-247 
initialization 5-96, 5-246, 5-247 
map of 1-29 
LPA system parameter 
cross-reference table 1-23 
Prap initialization 5-247 
Pp 
definition 5-289 
initialization 5-291 
LPBT initialization 5-291 
LQHT initialization 5-179, 5-326 
LRPT initialization 5-179, 5-326 
LSCT initialization 5-278 
LSID 
copy to QSRCD or EQSRD 5-255 
LXAT initialization -313 
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machine check handler 
See MCH 
machine check trap 
releasing of 3-5, 5-135 
setting of 3- a 5-67, 5-87 
machine check tra 
description of  NVTMCPSW 3-4 
setting of 5-67 
macro instructions 
IPL A-l 
NIP B-l 
magnetic tape volumes 
mounting 5-116 
opening 5-118 
mass storage system communicator 
See MSS 
mass storage system communicator 
RIM 5-499 
master catalog 1-24 
master console 
image buffer freed 5-532 
initialization 5-162 
Master scheduler 
wait routine 5-545 
IEEVWAIT 5-545 
master scheduler address space 
backed by real storage 5-638 
FBQE initialization 5-50 
frames backing 5-58 
initialize 5-54 
RAB 5-54 
RAX 5-54 
I0S buffers 5-76 
JSCB initialization 5-536 
RAB 5-54 
RAX 5-54 
RD initialization 5-50 
segment table 5-54, 5-269 
SRM user control blocks 5-286 
TCB 5-76, 5-532, 5-536 
TIOT initialization 5-50 
UOCB initialization 5-286 
UGXB initialization 5-286 
master scheduler initialization 
data sets used during 1-16 
description of RIM for 1-8 
error recovery during 1-18 
IEEVIPL 5-559 
Interface to General Parmlib Scan 
Routines. 1-8 
overview of initiation process 4-25 
Parameters passed by NIP 5-426 
program organization 1-9 
RIM 
IEAVNP13 5-425 
SMF 5-629 
IEEMB820 5-629 
master scheduler wait routine 
See ITEEVWAIT 
master subsystem's SSCVT 5-617 
master trace 
service routines 5-560 
use by communications task console 
queueing service 5-585 
master trace table 
data area 2-4 
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initialization 5-562 
Size 5-426 
master wait task subtasks 
TCB structure 3-2 
MAXDORM 
description of SMF keyword 5-631 
MAXUSER system parameter 
cross-reference table 1-23 
definition 1-21 
processing 5-266 
MCH 
description of RIM for 1-6 
initialization 5-88, 5-134 
releasing of traps 5-135 
RIM 
IEAVNPO06 5-88, 5-134 
setting of traps 5-67, 5-86, 5-87 
MCHEAD initialization 5-430 
MCT initialization 5-278, 5-282 
message buffer pool 
obtain storage for 5-134 
Message Queue Element 
MQE 2-2 
Message Queue Header 5-24 
MQH 2-2 
method of operation 5-1 
MIH initialization 1-9, 5-514 
MLPA 
See also LPA 
map of 1-29 
Page protection 5-274 
MLPA system parameter 
cross-reference table 1-23 
definition 1-21] 
model dependent values 5-286 
model system address space 
initialization 
function 5-547 
monitor call processing 5-104 
mountable device class array 5-623 
P 


MoE oes calculation 5-278 
data area 2-2 
MQH 5-24 
data area 2-2 
MSFCB initialization 5-128 
MSFKB initialization 5-128 
MSRDA 
initialization 5-426 
master trace service routine 
addresses 5-560 
MSS 


initialization 1-18, 5-499, 5-516 
path verification 5-104, 5-499, 
5-515 
UCB initialization 5-500 
MSSC 
See also MSS 
description of RIM for 1-8 
RIM 
IEAVNP19 5-109, 5-499 
MSTJCLO0 member of SYS].LINKLIB 
description 1-16 
MSTRJCL member of SYS].LINKLIB 
Processing 5-603 
MSTRJCL parameter 5-428 
MT parameter 
processing 5-426 
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cleanup processing 5-108 
data area during 2-1 
description of RIM for 1-7 
error recovery during 1-17 
establishing addressability 5-64 
exit processing 5-531 
ITEAVNPIX 5-531 
macro instructions’ B-1l 
module flow overview 4-4 
modules 
IEAVNIPM 5-83 
IEAVNIPO 5-66 
NIPPAREA data area description 2-3 
NVT data area description 2-3 
PARMTAB data area description 2-3 
program organization 1-6 
RIMs 
IEAVNIPX 5-108, 5-531 
IEAVNPX1 5-100 
IEAVNPO3 5-92, 5-170 
service routines 1-8, D-l 
NIPMOUNT 5-116 
NIPOPEN 5-118 
NIPWTO 5-110 
NIPNTOR 5-112 
NIPNTOR2 5-114 
SPE data area description 2-3 
system data sets used during 1-15 
TBVT copied 5-319 
TBVT initialization 5-79 
trace buffers copied 5-319 
trace buffers initialized 5-79 
NIP consoles initialization 5-90 
NIPABEND trap 
See also ABEND macro instruction 
description 3-4, 3-5 
NIPMCPSW trap 
See machine check traps 
NIPMOUNT service routine 
description of parameter list 2-3 
function 1-8, 5-116, D-l 
NIPOPEN service routine 
description of parameter list 2-4 
function 1-8, 5-118, D-l 
use of 1-15, 1-16 
NIPOPIO service routine 
function D-l 
NIPPAREA 
data area 2-3 
mapping macro description B-l 
NIPPRMPT service routine 
function 1-8, 5-171, D-l 
use in MAXUSER processing 5-267 
NIPSENSE service routine 
function 1-8, D-2 
NIPSVC trap 
See also LOCATE SVC, trap 
description 3-6 
NIPSWAIT service routine 
function 1-8, D-2 
NIPTIME service routine 
function 1-8, D-2 
NIPUCBFN service routine 
function 1-8, D-2 
NIPWTO service routine 
description of parameter list 2-4 
function 1-8, 5-110, D-2 
NIPWTOR service routine 
description of parameter list 2-4 


NIP 
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function 1-8, 5-112, D-3 
NIPWTOR2 service routine 
function 1-8, 5-114, D-3 
NLLE 
data area 2-2 
NOACTIVE 
description of SMF keyword 5-631 
NODETAIL 
description of SMF Keyword 5-632 
NOEXITS 
description of SMF Keyword 5-632 
NOINTERVAL 
description of SMF keyword 5-632 
NOLISTDSN 
description of SMF keyword 5-631 
NOMAXDORM 
description of SMF keyword 5-631 
non-DASD 
initialization 5-90, 5-158 
path verification 5-161 
testing availability of 5-161 
UCB initialization 5-159 
update DALT use count 5-650 
non-DASD initialization 5-90 
Non-direct Access Devices Initialization 
ITEAVNPO2 entry point IEAVNPA2 6-8 
IOS RIM -—- IEAVNPA2 6-8 
non-extended private area 
storage allocation 5-42 
non-IPL processor 
initialization 5-108 
NONVIO system parameter 
cross-reference table 1-23 
definition 1-21 
processing 5-216 
NOPROMPT 
description of SMF Keyword 5-631 
NORESTART codes 5-482 
NOSTART keyword 5-645 
NOSTATUS 
description of SMF keyword 5-631 
NOTYPE 
description of SMF keyword 5-632 
NPRTIMTAB trap 
See also RIM traps 
description 3-6 
NPORTPO1-15 trap 
See also RIM traps 
description 3-4 
NPOUXPC trap 
See also program check, traps 
description 3-5 
nucleus 
See also DAT-off nucleus and DAT-on 
nucleus 
clearing of storage 1-3 
page frame table initialization 5-58 
nucleus frames 
extended read-only 5-56 
extended read-write 5-56 
read-only 5-56 
read-write 5-56, 5-57 
NUCMAP 5-57 
PFTE 5-57 
nucleus initialization module 
See NIP 
Nucleus Load List Element 
NLLE 2-2 
nucleus map 
See NUCMAP 
Nucleus Map creation 
IEAIPLO5 5-33 
NUCMAP 
building 5-10, 5-33 
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data area 2-2 
definition 5-34 
entry format 5-34 
Page protection 5-274 
NVT 
data area 2-3 
description 5-71 
IHANVT mapping macro description B-l 
initialization 5-70, 5-71, 5-85 
moved to SQA 5-85 
released 5-534 
NVTMCPSW trap 
description 3-4 
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open processing 
ILRASRM2 5-218 
Open SYS1.LOGREC 5-90 
Open SYS1.SVCLIB 5-90 
operator communication established 5-91 
operator console 
opening 5-582 
operator interface 
during initialization 1-24 
during IPL 1-3, 1-26 
during NIP 1-23, 1-25 
during SYSGEN 1-24 
during TOD clock 
initialization 5-520 
using START command 1-10 
operator prompt for TOD 5-501 
OPERTAB 
merged into PLIBTAB 5-171 
OPI system parameter 
cross-reference table 1-23 
definition 1-21 
processing 5-171 
use of 1-24 
OPT system parameter 
cross-reference table 1-23 
definition 1-21 
processing 5-278 
ORE 
initial quick cell pool for 5-583 
initialization 5-576 
set limit for 5-583 
output class 
for system log data sets 5-428 
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page data sets 
opening 5-93, 5-96 
page frame table 5-40 
for common area 5-269 
for EFLPA 5-269, 5-274 
for EMLPA 5-274 
for EPLPA 5-274 
for FLPA 5-269, 5-274 
for HSA 5-58 
for MLPA 5-274 
for nucleus 5-58 
for NUCMAP 5-274 
for PLPA 5-274 
for PSA 5-58 
for read-only nucleus 5-274 
for V=R region 5-176, 5-270 
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initialization during IPL 5-12 
PAGE system parameter 
cross-reference table 1-23 
definition 1-21 
Processing 5-195 
use of 1-24 
Page tables 
initialized for CSA 5-257, 5-259 
initialized for ECSA 5-259 
initialized for ESQA 5-214 
initialized for LSQA 5-195 
initialized for SQA 5-212 
mapping 5-56 
Paging data sets 
contents 1-16 
data set name list initialized 5-640 
initializing 5-195 
Paging device 
initialization 5-195 
PAGNUM system parameter 
cross-reference table 1-23 
PAGTOL system parameter 
definition 1-21 
PAGTOTL system parameter 
Parsing 5-195 
PAK system parameter 
cross-reference table 1-23 
definition 1-21 


parameters 
See also system parameters 
system 
description of 1-6 
parmlib 


See SYS1.PARMLIB 
PARMLIB processing 
CLOCKxx 5-501 
IEAVNP20 5-501 
IEEMB888 5-438 
scan routine 5-438 
syntax scanning 5-438 
Parmlib read routine 
IEEMB878 5-641 
PARMLIB statements 
PPT 5-457 
PARMTAB 
data area 2-3 
initialization 5-171 
mapping macro description 8-1 
Parse data set names 
ILRASRM2 5-216 
Parse setup routine 
ISGNPARS 5-192 
PART 
initialization 5-220 
PART initialization 5-638 
PAT initialization 5-638 
PC/“AUTH 
AXAT initialization 5-313 
description of RIM for 1-7 
ETIB initialization 5-313 
initialization 5-308 
ee initialization 5-313 
IM 
IEAVNPF5 5-102, 5-308 
XMD ianitialization 5-313 
PC“AUTH address space 
attribute list initialization 5-309 
initialization 1-10, 1-12, 5-102, 
5-308, 5-310 
module flow 4-9, 4-15 
PCCA initialization 5-73 
PDS directory 
ISVCFIND IPL SVC 5-19, 5-20 
use in loading nucleus’) 5-3/7 
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PFTE anitialization 5-55 
PGN aniatialization 5-286 
PLIBTAB entries 5-171 
PLPA 
See also LPA 
data set marked read-only 5-255 
data set opening 5-96, 5-195 
directory 5-247 
I“0O0 error recovery 1-18 
initialization 5-246, 5-255 
map of 1-29 
page protection 5-274 
rebuilding 5-197 
reloading after first IPL 1-19 
power-up 


first IPL after 1-19 
PPT 

IEFPPT 5-457 

in SCHEDULxx 5-457 

scanner 5-457 


validating PPT statements 5-457 
PRIMARY keyword 5-645 
private page table array 
initialization 5-46 
process SYS]1.PARMLIB member 
JEEMB887 5-192 
processor-related control blocks 
initialization 5-70 
program call/authorization 
See PC/AUTH address space 
program check 
definition of NPOUXPC 3-5 
processing during IPL 5-23 
processing during NIP 1-17 
setting of traps 1-17, 5-69 
program function Keys 5-582 
program management 
See contents supervisor 
program organization 4-1 
Program Properties scanner 
Program Properties Table 
Program Status Word 5-22 
PROMPT 
description of SMF keyword 5-631 
prompting the operator for TOD 5-501 
Providing component services 1-13 
PSA 
for IPL processor 5-76 
initialize frame 5-56 
map of 1-27, 1-28, 1-29 
reverse prefix 5-42 
SYSGEN 5-42, 5-65 
template 5-101 
PSW 
build and load 5-22 
PSW build 5-22 
PURGE system parameter 
cross-reference table 1-23 
definition 1-2] 
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QDB 

used by OPEN macro instruction 
QSRCD 

data area 2-4 

initialization 5-195, 5-255 

mapping macro description  B-]l1 

use during LPA initialization 
quick cell pool 

for ASM 5-220 


5-457 
5-457 


5-582 


5-174 
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for communications task 5-583 
quick start 
definition 1-18 
Processing 5-195, 5-211 
quick start record 
See QSRCD and EQSRD 
quick start record extension 
See XQSRD 
QWB 
copy routine initialization 5-326 
initialization 5-179 
Placed on process queue 5-350 
released 5-327 
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RAB 
initialization 
RACF data sets 
contents 1-~16 
RACF processing 
TCB structure in master scheduler 
region 3~2 
RD initialization 5-50 
RDE parameter 5-423 
RDE system parameter 
cross-reference table 1-23 
definition 1-2] 
RDRTNEOR 
error routine in ISGJPARM 5-193 
read-only nucleus 
loaded into virtual storage 5-37 
page protected 5-274 
page protection 5-274 
read-only nucleus frames 5-56 
read-write nucleus 
loaded into virtual storage 5-3/7 
read-write nucleus frames 5-56 
real storage 
allocating contiguous frames 5-20 
see ISVCSTOR 5-20 
allocation during IPL 5-21 
backing by ISVCPGFX 5-19 
clearing of 5-7 
DAT-off nucleus loaded into 5-10 
DAT-on to DAT-off linkage table 5-36 
during IPL loading 17-26 
ISVCLOAD 5-20 
load a module into 5-20 
real storage management 
See RSM 
real storage map 
during IPL loading 1-26 
REAL system parameter 
cross-reference table. 1-23 
definition 1-21 
Processing 5-94, 5-98, 5-176, 5-270 
reason codes 
5-544 


from LEEMB8&81 
REC 
description of SMF Keyword 5-631 
reconfiguration 
cescription of RIM for 1-6 
RIM 
IEAVNPOO 1-25, 5-108 
RSM storage allotment 5-272 
recovery processing 
See error recovery 
Recovery Termination Management 
initialization 5-633 
IEAVTMSI 5-633 


5-12, 5-40, 5-269 
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region control task processing 


reloading the PLPA 
first IPL after 

5-G23 

RER system parameter 
cross-reference table 


RER parameter 


definition 


1-21 


1-19 


1-135 


1-23 


resource management routines 
obtaining addresses of 5-560 


resource names list 5-186 
RNL verification routine 


5-190 


RESTART codes 5-482 
return codes 
from IEEMB881 5-544 
from MCH RIM 5-137 
RIB initialization 5-349 
Ripe initialization 5-349 
IEAVRTOD 5-523 
RIMs 
description of modules 1-6 
IEAVAPOO 5-106, 5-515 
IEAVNIPX 5-108, 5-531 
IEAVNPA1 5-102, 5-360 
IEAVNPA2 5-158 
IEAVNPA27 5-138 
function 5-138 
IEAVNPA6 5-88, 5-130, 5-131, 5-132 
IEAVNPA8 5-96, 5-210 
IEAVNPB2 5-90, 5-168 
IEAVNPB8& 5-98, 5-257 
IEAVNPC1 5-90, 5-162 
IEAVNPD1 5-100 
IEAVNPD2 5-100 
IEAVNPD6 5-100, 5-264 
IEAVNPD8& 5-98, 5-268 
IEAVNPE6 5-88, 5-128 
IEAVNPE&8 5-94, 5-176 
IEAVNPF2 5-106, 5-513 
IEAVNPF5 5-102, 5-308 
IEAVNPX1 5-100 
IEAVNPOO 5-108 
IEAVNPO2 5-90 
IEAVNPO3 5-92 
IEAVNPO5 5-96 
IEAVNPO06 5-88, 5-134 
IEAVNPO9 5-100, 5-266 
IEAVNP1B 5-106 
IEAVNPLF 5-98, 5-288 
IEAVNP10 5-98, 5-276 
IEAVNP1L1 5-92 
IEAVNP13 5-104, 5-425 
IEAVNP16 5-104, 5-423 
IEAVNP17 5-429 
IEAVNP18& 5-431 
IEAVNP19 5-104, 5-499 
IEAVNPC2 5-499 
IEAVNP20 5-106, 5-501 
Module Description 5-501 
IEAVNP27 5-90 
IEAVNP33/ISGNTASC 5-102 
IEAVNPG7 5-98 
IEAVNP51 5-102, 5-318 
IEAVNP57 5-102, 5-356 
IEEMB888 5-438 
IEFABGIE 5-475 
Function 5-475 
Module Description 5-475 
IEFPPT -457 
IEFRCSTP 5-482 
Module Description 5-482 
ILRASRIM 5-96, 5-194 
ILRASRM1 5-96 
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ISGNCBIM 
function 5-178 

ISGNTASC 5-320 

loading 5-88 

module flow overflow 4-4 
RIT 

copied to RSH 5-274 

initialization 5-12 
RMCT initialization 5-276 
RMPT initialization 5-276 
RNL PARMLIB processor 


ISGNRNLP 
function 5-186 
RNL validation 5-181 
RNLs 5-186 
RPL build area 5-640 
RQA 
initialization 5-179, 5-326 


released 5-327 
RSH 

copied from RIT 5-274 
SM 


address space block 5-269 

allocation for storage 5-40 
available frame queue 5-62 
description of RIM for 1-7 


initialization 5-94, 5-98 
IRIM 

IEAIPLO6 5-12, 5-53 
page frame table 5-40 
RIMs 

IEAVNPD&8 5-98, 5-268 

IEAVNPE8 5-94, 5-176 


second level table 
initialization 5-46 
use in address space 
termination 5-635 
RSM control block 
initialization 5-12 
RSU system parameter 
cross-reference table 
definition 1-22 
processing 5-98, 5-272 
RSVNONR system parameter 
cross-reference table 
definition 1-22 
RSVSTRT system parameter 
cross-reference table 
definition 1-22 
RTC 
processing 1-13 
RTCT initialization 
RTM 
control table initialization 5-13] 
description of NPRIMTAB 3-6 
description of NPORTPO1-15 3-4 
description of RIM for 1-6 
initialization 5-88, 5-100, 5-130, 


-633 

IEAVTMSI 5-633 
interface with traps 5-100 
recording task initialization 
releasing of traps 5-534 


1-23 


1-23 


1-23 


5-131, 5-359 


5-131 


RIMs 
IEAVNPA6 5-88, 5-130 
IEAVNPD6 5-100 
setting of traps 5-66, 5-67, 5-86 
RTM traps 
for non-master scheduler address 
spaces 5-10] 


releasing of 3-5, 5-534 
setting of 3-5, 5-66, 5-67, 5-86 
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SAHT initialization 
SART initialization 
SAST 
building 5-617 
chaining to the JESCT 5-617 
initialization 1-9, 5-606, 5-648 
initializing 5-617 
rebuilding 1-14 
SAST initialization 5-605 
scanning EDT statement 5-475 
scanning PARMLIB members 5-438 
scatter list 
location 5-7 
SCCW initialization 
for swap data set 5-201 
for swap data sets 5-201 
SCH system parameter 
cross-reference table 1-23 
definition 1-22 
scheduled commands table 


5-326 
5-640 


loading 5-428 
SCHEDULxx 

NORESTART codes 5-482 

PPT processing 5-457 

RESTART codes 5-482 


SCHEDxx member of SYS1.PARMLIB 
description 1-22 
SCHEDxx processing 5-431 
SCHIB 
initialization by SRM 5-291 
update 5-159 
SCP INFO data for service 
processor 5-523 
SDT ianitialization 5-552 
second level table initialization 5-46 
segment table 
for master scheduler 5-269 
initialization during IPL 5-46 
segments 
creation 5-22 
SEND command 
setting broadcast record limit 
for 5-562 
service processor 
attention block initialization 
communication block 
initialization 5-128 
description of RIM for 1-6 


RIM 
IEAVNPE6 5-88, 5-128 
service processor CALL SVC 
initialization 5-88, 5-128 

service processor interface routine 

function 5-10 
service routines 

IPL C-l 

NIP 1-8, D-l 
SET initialization 
SHAS 

description 5-619 

initialization 5-648 
SIC routine 

loading of 5-560 
SID 

description of SMF keyword 5-63] 
SMCA 

relation of SMF keyword parameters to 

fields in 5-63] 


5-128 


5-315 


SMEW initialization 5-359 
SMF 
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data sets opened 5-630 
ina kyalization 1-9, 1-25, 5-426, 
initialization records 5-630 
parameter table 5-426 
Parameters passed from NIP ra 426 
relationship between keywor 
Parameters and SMCA fields 5-631 
relationship between keyword 
Parameters and SST fields 5-632 
SMF address space 
initialization 1-12 
SMF system parameter 
cross-reference table 1-23 
definition 1-22 
SMFPRMxx member of SYS1.PARMLIB \ 
description 1-22 
processing 5-631 
SMPL initialization 
SPE 
description of data area 273 
freed 5-532 
SQA 
AQAT initialization 5-2l1l 
AQATINDX initialization 5-211 
backed with real frames 5-42 
DFE initialization 5-212 
frames backing 5-58 


5-179 


initialization 5-12, 5-462, 5-96, 
5-211 
map of 1-27, 1-28, 1-29 


Page tables initialized 5-212 
use in SRM initialization 5-280 
SQA system parameter 
cross-reference table 1-23 
definition 1-22 
Processing 5-96, 5-211 
sear initialization 5-46, 5-48 
for ASM read/write routine 
for RTM 5-634 
SRB mode 
RTM support for 
SRM 
channel measurement function 
initialization 5-98, 5-288 
cescraption of RIM for 1-7 


initialization 5-277 
ICT initialization 5-277 
initialization 5-98, 5-277 
notification by TOD clock 
initialization 5-522, 5-528 
OPT system parameter 5-278 
RIMs 
IEAVNPLF 5-98, 5-288 
IEAVNP1O 5-98, 5-276 
RMCT initialization 5-277 
RMPT initialization 5-277 
tuning parameters 5-278 
SSCVT 
initialization 1-14, 5-609 
initialization for subsystems 5-604 
master subsystem's 5-617 


description 5-582 

initialization 5-556 

initialization for communications 

task 5-581] 

used by initiator 5-560 
SSN system parameter 

cross-reference table 1-23 

definition 1-22 

processing 5-426, 5-642 


5-205 


5-131 


SSI 
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5-556 
5-603 


SSOB initialization 
SSPL initialization 
SST 
relation of SMF Keyword parameters to 
fields in 5-632 
SSVT 
for master subsystem 5-535 
function matrix 5-612 
initialization 1-14, 5-611 
STAE/ESTAE trap 
description 3-5 
START command 
CSCB initialization 1-12, 5-537, 
5-553 
starting the IPL subchannel 5-22 
STATUS 
rosso te tion of SMF keyword 5-631 
S 
module flow overview 4-28 
processing 1-13, 5-549 
STCINRDR 
description 1-17 
device allocation for 4-25 
STCPS work area 5-289 
storage maps 
See virtual storage maps or real 
storage maps 
subchannel initialization 5-90 
subchannels 
initialization 5-90 
SCHIB update 5-159 
UCB initialization 5-159 
subchannels initialized 5-91 
SUBPARM 
description of SMF Keyword 5-631 
SUBSYS 
description of SMF keyword 5-631 
Subsystem 


initialize SSCVT storage 5-609 
interface routine 5-425 
JESCT 5-425 
primary 5-609 

initialization 5-609 
validating the name 5-609 


subsystem allocation sequence table 
SAST initialization 5-605 
subsystem communication table 
initialization 5-603 
IEFJSINT 5-603 
subsystem communication vector table 
SSCVT 5-605 
initialization 5-605 
Subsystem initialialization 
disabling selected SSVT 
functions 5-614 
enabling selected SSVT 
functions 5-614 
subsystem initialization 
console id 5-641 
IEFJSBLD 5-647 
IEFSSNxx processing 5-64] 
IIEFJSIN2 5-641, 5-647 
NOSTART keyword 5-645 
PRIMARY keyword 5-645 
prompt for subsystem name 
subsystem interface | 
initialization -14, 5-603 
routine CT EF ISREQ) 5- 426 
use of JES name table 5-603 
subsystem name 5-609 
subsystem names table 
See IEFJSSNT 
Subsystem Service Routine 
See also IEFJSBLD 


5-647 
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IEFJSBLD 5-609 
subsystems 
initialization 1-14, 5-641 
module flow 4-13 
module flow overview of 
initialization 4-29 
subsytem name 5-647 
supervisor control 
description of RIM for 1-7 
initialization 5-266 


IRIM 
IEAIPLO7 5-12, 5-13 
RIM 
IEAVNPO9 5-100, 5-266 
SVC dump 
IEAVNPDI 5-296 
IEAVTSDI 5-296 
initialization 5-100, 5-296 
RIM 1-16 
task 5-634 
SVC PARMLIB Processing 
function 5-222 


SVC system parameter 
definition 1-22 
SVC table 
ABEND initialization 5-534 
AMODE bit initialization 5-13 
ENQ and DEQ initialization 5-327 
LOCATE initialization 5-534 
SVC types 3 and 4 
description of NIPSVC 3-6 
releasing of traps 3-5, 5-86 
setting of traps 3-5, 5-86 
SVC 1 see ISVCXDAP 5-16 
SVC 10 see ISVCSYNC 5-22 
SVC 11 see ISVCCSEG 5-22 
SVC 2 see ISVCDAT 5-18 
SVC 3 see ISVCEXIT 5-18 
SVC 4 see ISVCPGFX 5-18 
SVC 5 see ISVCFIND 5-20 
SVC 6 see ISVCLOAD 5-20 
SVC 60 trap 
description 3-5 
SVC 7 see ISVCSTOR 5-20 
SVC 8 see ISVCCNVT 5-22 
SVC 9 see ISVCSSCH 5-22 
SVCFLIH 5-18 
SVT initialization 5-314 
SWA management routines 
swap data sets 
contents 1-16 
data set name list initialized 5-640 
opening 5-93, 5-96, 5-220 
SWAP system parameter 
cross-reference table 1-23 
definition 1-22 
symbol usage table 2-1 
syntax scanning 5-438 
SYS 
description of SMF keyword 5-631 
uae member of SYSI]1.NUCLEUS 1-24, 
SYSNAME system parameter 
cross-reference table 1-23 
definition 1-22 
processing 5-95, 5-181 
SYSP system parameter 
cross-reference table 1-23 
definition 1-22 
processing 5-92, 5-171 
SYSRES 
IEAIPLO3 5-14 
UCB initizclization 5-14 
system authorization table 


5-560 


5-311 
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system catalog 
catalog locate parameter lists 
closing 5-106 
contents 1-15 
opening 5-92, 5-93 
system component address spaces 
create routine 5-535 
creating 1-12 
defining 1-12 
initialization using IEEMB88&l 4-30 
initializing 1-10 
map of 1-10 
WAIT/POST routine 5-545 
system component services 
providing 1-12 
system console 
alternate console 
initialization 5-162 
initialization 5-90, 5-162 
master console initialization 
open SYS1.DCMLIB 5-582 
system crash 
first IPL after 1-19 
system data sets 
JCL written into 5-558 
opening of 5-93 
used by IPL 1-15 
used by master scheduler 1-16 
used by NIP 1-15 
system data sets opened 5-91 
System devices 
UCB initialization 5-14 
IEAIPLO3 5-14 
system generation 
first IPL after 1-19 
system initialization 
definition of 1l-l 
error handling 1-17 
module flow overview 4-2 
summary diagram 1-2 
system link library creation 
system linkage table 5-3ll 
system log 
initialization 5-570 
initialization during NIP 
maximum number of messages 
output class 5-428 
system management facility 
initialization 
overview 4-26 
System Managment Facilities 
IEEMB881 5-629 
IEFSMFIE 5-629 
initialization 
System Parameter 
GRSCNF 5-183 


5-201 


5-162 


5-172 


5-428 
5-428 


5-629 


GRSRNL 5-186 
processing 5-92, 5-95, 5-98 
APF 5-92 
CLPA 5-95 
CSA 5-98 
CVIO 5-95 
ECSA 5-98 
ENF 5-98 
GRS 5-95 


GRSCNF 5-95 
GRSRNL 5-95 

LNK 5-92 
LNKAUTH 5-92 
REAL 5-95, 5-98 
RSU 5-98 
SYSNAME 5-95 
SYSP 5-92 
VRREGN 5-98 
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System parameter queue 
EQSRD 2-2 
Extended quick start record 2-2 
IPL Vector Table CIVT) 2-] 


IVT 2-1 
Master Trace Table 2-4 
MTT 2-4 
NCT 2-3 


NIP Console table 2-3 
NIP parameter address table 2-3 
NIP parameter area 2-3 
NIP parameter queue entry 2-3 
NIP vector table 2-3 
NIPMOUNT 2-3 
NIPPAREA 2-3 
NIPNTO 2-4 
NIPNTOR parameter list 2-4 
nucleus map 2-2, 2-4 
NUCMAP 2-2 
NVT 2-3 
PARMTAB 2-3 
QSRCD 2-4 
Quick start record 2-4 
Quick start record extension 2-4 
SPE 2-3 
XQSRCD 2-4 
system parameters 
analyzing 5-170 
CON= 5-360 
description of 1-20 
passed from NIP to master 
scheduler 5-426 
Processing 5-426 
sources 1-24 
system paramter 
CSA initialized 5-257 
system services 
using 1-13 
system tasks 
permanent 
initialization of 1-9 
system trace 
address space initialization 
module flow 4-16 
buffers initialized 5-319 
description of RIM for 1-7 
initialization 5-102, 5-318 
NIP TBVT initialization 5-79 
NIP trace buffers initialized 5-79 
RIM 
IEAVNP51 5-102, 5-318 
TBVT initialization 5-319 
system trace address space 
See TRACE address space 
SYS1.BRODCAST 
contents 1-17 
device allocation for 4-25 
SYS1.DCMLIB 
opening 5-582 
SYS1.DUMPx~x 
contents 1-16 
SYS1.LINKLIB 
contents 1-15, 1-16 
function 1-9 
member MSTJCLxx 1-9 
member MSTJCLOO 1-16 


member MSTRJCL 5-603 

opening 5-172 
SYS1.LOGREC 

contents 1-15, 1-16 

member IFCDIPO00 1-19 

opening 5-90, 5-93 


SYS1.LOGREC opened 5-90, 5-91 
SYS1.LPALIB 
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contents 1-16 
loading modules into storage 5-247 
opening 5-247 
use 5-247 
SYS1.MANn 
contents 1-16 
SYS1.NUCLEUS 
contents 1-15 
definition 1-3 
initializing 5-80 
the DCB 5-80 
the DEB 5-80 
loading member into real 
storage 5-21 
ISVCLOAD 5-21 
member SYSCATLG 5-93 
reading member 5-21 
ISVCFIND 5-21 
system catalog member 5-92, 5-106 
SYS1.PARMLIB 
analyzing system parameters 5-170 
contents 1-16, 1-17 
device allocation for 4-25 
function 1-9 
IEAPSPIO mapping macro 
description  B-1 
IEAVNPM4 description 5-120 
member CLOCK -20 
member COMMNDxx 5-426 
member CONSOLxx 1-20 
member GRSCNFxx 1-20, 5-181 
member GRSRNLxx 1-20, 5-181 
member IEAAPFxx 1-20 
member IEAAPP00 5-424 
member IEAFIXxx 1-20 
member IEAICSxx 1-20, 5-280 
member ITEAIPSxx 1-21, 5-280 
member ITEALPAxx 1-21 
member IEAOPTIxx 1-21, 5-278 
member IEAPAK00 5-247 
member IEASVCxx 1-22 
member IEASYSxx 1-22, 5-171 
member IEASYSOO 1-19 
member IECIOSxx 1-20, 5-514 
member IEFSSNxx 1-15, 1-22, 5-426, 
5-642, 5-644 
member LNKLSTxx 5-172 
member SCHEDxx 1-22 
member SMFPRMxx 1-22, 5-426, 5-631 
member VATLSTxx 1-22, 5-515 
members 1-20 
description of 1-20 
opening 5-93, 5-170 
SCHEDULxx 5-482 
NORESTART codes 5-482 
RESTART codes 5-482 
SYS1.PROCLIB 
contents 1-17 
device allocation for 4-25 
function 1-10 
SYS1.STGINDEX 
contents 1-16 
VIO data set restoration 5-638 
SYS1.SVCLIB 
contents 1-15 
opening 5-90, 5-93 
SYS1.SVCLIB opened 5-90, 5-91 
SYS1.UADS 
contents 1-17 
device allocation for 4-25 


I-26 MVS/XA System Init Logic 


"Restricted Materials of IBM" 
Licensed Materials ™ Property of IBM 


tables 
data area 2-1 
usage table 2-1 
tape device 
CMB entries 5-289 
DCTI initialization 5-291 
LPB initialization 5-291 
mounting 5-116 
task input output table 
initialized 5-581 
task management 
See supervisor control 
task recovery 
See also dumping services 
initialization 5-100 
Task Recovery Initialization 5-264 
TBVT initialization 
for NIP 5-79 
for system trace 5-319 
TCB 
for master scheduler address 
space 5-76, 5-532, 5-536 
for system address spaces 5-534, 
5-546 
TCB structure following 
initialization 3-2 
TCWA 
defined 5-517 
initialization 5-517 
Time of Day 
see IEAVNP20 5-501 
time-of-day 
See TOD 
Timer 
initialization 5-523 
timer unit 
time zone constant 5-426 
TIOT 
DD statements allowed 5-623 
initializing the size 5-623 
used by OPEN macro instruction 5-582 
TIOT anitialized 5-581 
TOD 5-501 
TOD clock on IPL processor 
IEAVRTOD initializes 5-84 
initialization 5-68, 5-108, 5-426, 
5-517, 5-523 
status messages 5-520 
store information for 
initialization 5-105 
TCWA initialized 5-517 
testing 5-84 
time zone constant 5-426 
TQE initialized 5-517 
TOD parameter 
Processing 5-426 
TPARTBLE 
copied to data set name list 5-640 
initialization 5-195 
use in PART initialization 5-220 
trace 
See system trace or master trace 
TRACE address space 
initialization 1-10, 1-12, 5-319 
module flow 4-9, 4-16 
trace buffers initialized 
for NIP 5-79 
for system trace 5-319 
translation lookaside buffer 
Purged 5-274 
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translation mode 5-18, 5-19 
translation table 

location 5-7 

use in loading DAT-on nucleus'7 5-37 
traps 

error set by NIP 3-4 
TSO SEND command 

setting broadcast record limit 


for 5-562 
TSO service routine 
initialization 5-562 
TSOINRDR 


description 1-17 
device allocation for 4-25 
TTR address 5-22 
5-278 


tuning parameters 
TYPE 

description of SMF Keyword 5-632 
types of IPL 1-18 


[Lv | 


UCB initialization 
for DASDs 5-168 
for DASDs with mounted volumes 5-516 
for DASDs with MSS volumes 5-516 
for master console 5-162 
for MSS 5-500 
for non-DASDs 5-161 
for subchannels 5-159 
for SYSRES 5-14 
for system devices 5-14 


for volume attribute 5-516 
UCM 
description 5-582 
fixed and pageable extension 
bases 5-585 
for display consoles 5-581 
for master console 5-162 
to open consoles 5-576 
UCM initialization 5-414 
UCME 
fixed and pageable extension 
bases 5-585 
UOCB initialization 5-286 
UOXB initialization 5-286 


UPL 5-623 
usage table 2-l 
use attributes 

initialization 5-516 
useable frame queue initialized 5-6 
user control of initialization 1-18 
using system services 1-13 


V=R region 
adjustment 5-270 
AIM initialization 5-176 
frames marked non-preferred 5-176 
initialization 5-50 
page frame table 5-269 
REAL system parameter 5-176, 5-270 
VRREGN system parameter 5-270 

V=V regions 
initialization 5-50, 5-96 
limits set 5-50 
map of 1-29 
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VAL system parameter 
cross-reference table 1-23 
definition 1-22 
processing 5-516 
validating EDT statement 5-475 
validating PPT statements 5-457 
VATLSTxx 
SYS1.PARMLIB member processing 5-515 
VATLSTxx member of SYS1.PARMLIB 
description 1-22 
processing 5-516 
VIO data set 
ASM initialization 
Preservation during 
initialization 1-18 
virtual DASD 
See MSS 
virtual storage 
See also virtual storage maps 
backed with real frames 5-18 
ISVCPGFX 5-18 
DAT-on nucleus loaded into 5-10 
during IPL loading 1-26 
initial mapping 5-7 
real storage backing 5-19 
virtual storage maps 
multiple address spaces 1-10 
on exit from IEAIPLOG 5-53 
on exit from IEAIPL99 1-27 
on exit from IEAVNIPX 1-29 
on exit from IEAVNIPO 1-28 
system initialization summary 1-2 
volume attribute 
description of RIM for 1-8 


IM 
IEAVAPOO 5-106, 5-515 
VRREGN system parameter 
cross-reference table 1-23 
definition 1-22 
processing 5-98, 5-270 


5-638 


VSAM 
description of RIM for 1-7 
initialization 5-93, 5-101, 5-106 
RIMs 
IEAVNP1B 5-106 
IEAVNP11 5-92 
VSM 


description of RIM for 1-7 

IEAIPLOG 5-40 

initialization 5-96, 5-210 
IEAIPLOG 5-12 


IRIM 
s 
IEAVNPA& 5-96, 5-210 


IEAVNPB& 5-98, 5-256 
5-G0, 5-G8, 5-49 


VSWK 
initialization 


[Lv ] 


wait state code x'64' description 3-7 
warm start 

definition 1-18 

processing 5-195, 5-211, 5-638 
WMST initialization 5-280 
Wore oS manager control 5-280 


initial quick cell pool for 5-583 
initialization 5-576 
set limit for 5-583 
shortage of 5-586 
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WTOBFRS system parameter 
Processing 5-102 | x | 
WTORPLY system parameter 
Processing 5-102 





X"'64' wait state code 3-7 
XCTL SVC 
setting of traps 5-86 
XMD initialization 5-313 
XQSRD 
data area 2-4 
mapPing macro description B-l 
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